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Foreword 

This Technical Specification has been produced by the 3^^ Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 
where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 

Introduction 

The present document is part 4 of a multi-part TS covering the 3^^ Generation Partnership Project: Technical 
Specification Group Core Network; Open Service Access (OS A); Application Programming Interface (API), as 
identified below. The API specification (3GPP TS 29.198) is structured in the following Parts: 

Part 1: Overview 

Part 2: Common Data Definitions 

Part 3: Framework 

Part 4: Call Control SCF 

Part 5: User Interaction SCF 

Part 6: Mobility SCF 

Part 7: Terminal Capabilities SCF 

Part 8: Data Session Control SCF 

Part 9: Generic Messaging SCF 

Part 10: Connectivity Manager SCF 

Part 1 1 : Account Management SCF 

Part 12: Charging SCF 



(not part of 3GPP Release 4) 
(not part of 3GPP Release 4) 



The Mapping specification of the OSA APIs and network protocols (3GPP TR 29.998) is also structured as above. 
A mapping to network protocols is however not applicable for all Parts, but the numbering of Parts is kept. 
Also in case a Part is not supported in a Release, the numbering of the parts is maintained. 



OSA API specifications 29.198-family 


OSA API Mapping - 29.998-family 


29.198-1 


Part 1: Overview 


29.998-1 


Part 1: Overview 


29.198-2 


Part 2: Common Data Definitions 


29.998-2 


Not Applicable 


29.198-3 


Part 3: Framework 


29.998-3 


Not Applicable 


29.198-4 


Part 4: Call Control SCF 


29.998-4-1 


Subpart 1: Generic Call Control - CAP mapping 


29.998-4-2 




29.198-5 


Part 5: User Interaction SCF 


29.998-5-1 


Subpart 1: User Interaction - CAP mapping 


29.998-5-2 




29.998-5-3 




29.998-5-4 


Subpart 4: User Interaction - SMS mapping 


29.198-6 


Part 6: Mobility SCF 


29.998-6 


User Status and User Location - MAP mapping 


29.198-7 


Part 7: Terminal Capabilities SCF 


29.998-7 


Not Applicable 


29.198-8 


Part 8: Data Session Control SCF 


29.998-8 


Data Session Control - CAP mapping 


29.198-9 


Part 9: Generic Messaging SCF 


29.998-9 


Not Applicable 


29.198-10 


Part 10: Connectivity Manager SCF 


29.998-10 


Not Applicable 


29.198-11 


Part 11: Account Management SCF 


29.998-11 


Not Applicable 


29.198-12 


Part 12: Charging SCF 


29.998-12 


Not Applicable 
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Scope 



The present document is Part 4 of the Stage 3 specification for an AppHcation Programming Interface (API) for Open 
Service Access (OSA). 

The OSA specifications define an architecture that enables appHcation developers to make use of network functionality 
through an open standardised interface, i.e. the OSA APIs. The concepts and the functional architecture for the OSA are 
contained in 3GPP TS 23.127 [3]. The requirements for OSA are contained in 3GPP TS 22.127 [2]. 

The present document specifies the Call Control Service Capability Feature (SCF) aspects of the interface. All aspects 
of the Call Control SCF are defined here, these being: 

Sequence Diagrams 

Class Diagrams 

Interface specification plus detailed method descriptions 

State Transition diagrams 

Data definitions 

IDL Description of the interfaces 

The process by which this task is accomplished is through the use of object modelling techniques described by the 
Unified Modelling Language (UML). 

This specification has been defined jointly between 3GPP TSG CN WG5, ETSI SPAN 12 and the Parlay Consortium, 
in co-operation with a number of JAIN^m Community member companies. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 29.198-1 "Open Service Access; Application Programming Interface; Part 1: 

Overview" . 

[2] 3GPP TS 22.127: "Stage 1 Service Requirement for the Open Service Access (OSA) (Release 4)". 

[3] 3GPP TS 23.127: "Virtual Home Environment (Release 4)". 

[4] 3GPP TS 22.002: "Circuit Bearer Services Supported by a PLMN". 

[5] ISO 4217 (1995): "Codes for the representation of currencies and funds ". 

[6] 3GPP TS 24.002: "GSM-UMTS PubHc Land Mobile Network (PLMN) Access Reference 

Configuration" . 

[7] 3GPP TS 22.003: "Circuit Teleservices supported by a PubHc Land Mobile Network (PLMN)". 
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3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 29.198-1 [1] apply. 

3.2 Abbreviations 

For the purposes of the present document, the abbreviations given in TS 29.198-1 [1] apply. 

4 Call Control SCF 

Two flavours of Call Control (CC) APIs have been included in Rel.4. These are the Generic Call Control (GCC) and the 
Multi-Party Call Control (MPCC). The GCC is the same API as was already present in the Release 99 specification 
(TS 29.198 v3.3.0) and is in principle able to satisfy the requirements on CC APIs for Release 4. 

However, the joint work between 3 GPP CN5, ETSI SPAN 12 and the Parlay CC Working group with collaboration from 
JAIN has been focussed on the MPCC API. A number of improvements on CC functionality have been made and are 
reflected in this API. For this it was necessary to break the inheritance that previously existed between GCC and 
MPCC. 

The joint CC group has furthermore decided that the MPCC is to be considered as the future base CC family and the 
technical work will not be continued on GCC. Errors or technical flaws will of course be corrected. 

The following clauses describe each aspect of the CC Service Capability Feature (SCF). 

The order is as follows: 

• The Sequence diagrams give the reader a practical idea of how each of the SCF is implemented. 

• The Class relationships clause shows how each of the interfaces applicable to the SCF, relate to one another. 

• The Interface specification clause describes in detail each of the interfaces shown within the Class diagram part. 

• The State Transition Diagrams (STD) show transition between states in the SCF. The states and transitions are 
well-defined; either methods specified in the Interface specification or events occurring in the underlying networks 
cause state transitions. 

• The Data definitions clause show a detailed expansion of each of the data types associated with the methods within 
the classes. Note that some data types are used in other methods and classes and are therefore defined within the 
Common Data types part of this specification (29.198-2). 



5 The Service Interface Specifications 

5.1 Interface Specification Format 

This section defines the interfaces, methods and parameters that form a part of the API specification. The Unified 
Modelling Language (UML) is used to specify the interface classes. The general format of an interface specification is 
described below. 

5.1.1 Interface Class 

This shows a UML interface class description of the methods supported by that interface, and the relevant parameters 
and types. The Service and Framework interfaces for enterprise-based client applications are denoted by classes with 
name Ip<name>. The callback interfaces to the applications are denoted by classes with name IpApp<name>. For 



ETSI 



3GPP TS 29.198-4 version 4.1.0 Release 4 8 ETSI TS 129 198-4 V4.1.0 (2001-09) 

the interfaces between a Service and the Framework, the Service interfaces are typically denoted by classes with name 
IpSvc<name>, while the Framework interfaces are denoted by classes with name IpFw<name> 

5. 1 .2 Method descriptions 

Each method (API method "call") is described. All methods in the API return a value of type TpResult, indicating, 
amongst other things, if the method invocation was sucessfully executed or not. 

Both synchronous and asynchronous methods are used in the API. Asynchronous methods are identified by a 'Req' 
suffix for a method request, and, if applicable, are served by asynchronous methods identified by either a 'Res' or 'Err' 
suffix for method results and errors, respectively. To handle responses and reports, the application or service developer 
must implement the relevant I p App < n ame > or IpSvc<n ame > interfaces to provide the callback mechanism. 

5. 1 .3 Parameter descriptions 

Each method parameter and its possible values are described. Parameters described as 'in' represent those that must have 
a value when the method is called. Those described as 'out' are those that contain the return result of the method when 
the method returns. 

5.1.4 State Model 

If relevant, a state model is shown to illustrate the states of the objects that implement the described interface. 

5.2 Base Interface 

5.2.1 Interface Class Iplnterface 

All application, framework and service interfaces inherit from the following interface. This API Base Interface does not 
provide any additional methods. 



«lnterface» 
Iplnterface 



5.3 Service Interfaces 
5.3.1 Overview 

The Service Interfaces provide the interfaces into the capabilities of the underlying network - such as call control, user 
interaction, messaging, mobility and connectivity management. 

The interfaces that are implemented by the services are denoted as 'Service Interface'. The corresponding interfaces that 
must be implemented by the application (e.g. for API callbacks) are denoted as 'Application Interface'. 

5.4 Generic Service Interface 
5.4.1 Interface Class IpService 

Inherits from: Iplnterface 

All service interfaces inherit from the following interface. 
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«lnterface» 
IpService 



setCallback (applnterface : in IplnterfaceRef) : void 

setCallbackWithSessionID (applnterface : in IplnterfaceRef, sessionID : in TpSessionID) : void 



Method 
setCallback 

This method specifies the reference address of the callback interface that a service uses to invoke methods on the 
application. It is not allowed to invoke this method on an interface that uses SessionlD's. 

Parameters 

applnterface : in IplnterfaceRef 

Specifies a reference to the application interface, which is used for callbacks 

Raises 
TpCommonExceptions 



Method 
SetCallbackWithSessionID () 

This method specifies the reference address of the application's callback interface that a service uses for interactions 
associated with a specific session ID: e.g. a specific call, or call leg. It is not allowed to invoke this method on an 
interface that does not uses SessionlD's. 

Parameters 

applnterface : in IplnterfaceRef 

Specifies a reference to the application interface, which is used for callbacks 

sessionID : in TpSessionID 

Specifies the session for which the service can invoke the application's callback interface. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 
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6 Generic Call Control Service 

6.1 Sequence Diagrams 
6.1.1 Additional Callbacks 

The following sequence diagram shows how an application can register two call back interfaces for the same set of 
events. If one of the call backs can not be used, e.g., because the application crashed, the other call back interface is 
used instead. 



first instance : (Logical 
View::lpAppLoqic) 



: IpAppCallControlManaqer 



1 : new() 



^ 



6: 'forward event' 



(T 



second instance : 
(Logical View::lpA... 



: IpAppCallControlManager 



2: enableCallNotification( ) 



3: new() 



^ 



4: enableCallNotification( 



5: callEventNotify( 



7: "call Notify result: failure' 



: IpCallControlManager 



^ 



^ 



8: callEventNotify( ) 



9: "forward event" 



1 : The first instance of the application is started on node 1 . The application creates a new IpAppCallControlManager to 
handle callbacks for this first instance of the logic. 

2: The enableCallNotfication is associated with an applicationlD. The call control manager uses the applicationID to 
decide whether this is the same application. 

3: The second instance of the application is started on node 2. The application creates a new 
IpAppCallControlManager to handle callbacks for this second instance of the logic. 

4: The same enableCallNotfication request is sent as for the first instance of the logic. Because both requests are 
associated with the same application, the second request is not rejected, but the specified callback object is stored as an 
additional callback. 

5: When the trigger occurs one of the first instance of the application is notified. The gateway may have different 
policies on how to handle additional callbacks, e.g., always first try the first registered or use some kind of round robin 
scheme. 

6: The event is forwarded to the first instance of the logic. 
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7: When the first instance of the appHcation is overloaded or unavailable this is communicated with an exception to the 
call control manager. 

8: Based on this exception the call control manager will notify another instance of the application (if available). 

9: The event is forwarded to the second instance of the logic. 



6.1.2 Alarm Call 

The following sequence diagram shows a 'reminder message', in the form of an alarm, being delivered to a customer as 
a result of a trigger from an application. Typically, the application would be set to trigger at a certain time, however, the 
application could also trigger on events. 



: (Loaical 
View::lDADDLoaic) 


: IpAppCall 



IpAppUICall 



lpCallControlManaqer[ 



: IpCall 



IpAppUIManaqer 



: IpUICall 



1 : new() 



6: 'forward event' 



2: createCalK ) 



1 1 : 'forward event' 



^ 



3: new() 



-^ 



4: routeReq( ) 



-^ 



5: routeRes( ) 




n^- 



10: sendlnfoRes( ) 



12: release( ) 



13: release( ) 



-^ 



^ 



1 : This message is used to create an object implementing the IpAppCall interface. 

2: This message requests the object implementing the IpCallControlManager interface to create an object 
implementing the IpCall interface. 

3: Assuming that the criteria for creating an object implementing the IpCall interface (e.g. load control values not 
exceeded) is met it is created. 
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4: This message instructs the object implementing the IpCall interface to route the call to the customer destined to 
receive the 'reminder message' 

5: This message passes the result of the call being answered to its callback object. 

6: This message is used to forward the previous message to the IpAppLogic. 

7: The application requests a new UlCall object that is associated with the call object. 

8: Assuming all criteria are met, a new UlCall object is created by the service. 

9: This message instructs the object implementing the IpUICall interface to send the alarm to the customer's call. 

10: When the announcement ends this is reported to the call back interface. 

1 1 : The event is forwarded to the application logic. 

12: The application releases the UlCall object, since no further announcements are required. Alternatively, the 
application could have indicated P_FINAL_REQUEST in the sendlnfoReq in which case the UlCall object would have 
been implicitly released after the announcement was played. 

13: The application releases the call and all associated parties. 



6.1 .3 Application Initiated Call 



The following sequence diagram shows an application creating a call between party A and party B. This sequence could 
be done after a customer has accessed a Web page and selected a name on the page of a person or organisation to talk 
to. 
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: (Logical 
View::lpAppLogic) 



IpAppCall 



IpCallControlManager 



: IpCall 



1 : new() 



^ 



2: createCalK ) 



^ 



3: new() 



4: routeReq( 



^ 



^^ 



6: 'forward event' 



tr 



^ 



5: route Res( 



7: routeReq( 



^^ 



8: route Res( 



9: 'forward event' 



(r 



^ 



10:deassignCall( ) 



^1 
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1 : This message is used to create an object implementing the IpAppCall interface. 

2: This message requests the object implementing the IpCallControlManager interface to create an object 
implementing the IpCall interface. 

3: Assuming that the criteria for creating an object implementing the IpCall interface (e.g. load control values not 
exceeded) is met, it is created. 

4: This message is used to route the call to the A subscriber (origination). In the message the application request 
response when the A party answers. 

5: This message indicates that the A party answered the call. 

6: This message forwards the previous message to the application logic. 

7: This message is used to route the call to the B-party. Also in this case a response is requested for call answer or 
failure. 

8: This message indicates that the B-party answered the call. The call now has two parties and a speech connection is 
automatically established between them. 

9: This message is used to forward the previous message to the IpAppLogic. 

10: Since the application is no longer interested in controlling the call, the application deassigns the call. The call will 
continue in the network, but there will be no further communication between the call object and the application. 



6.1.4 Call Barring 1 

The following sequence diagram shows a call barring service, initiated as a result of a prearranged event being received 
by the framework. Before the call is routed to the destination number, the calling party is asked for a PIN code. The 
code is accepted and the call is routed to the original called party. 
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: (Logical : IpAppCallControlManaqer] : IpAppCalF j ^ ^ : IpCall ^ : IpUICalT 

View::lpAppLoqic) IpAppUICall IpCallControlManaqer IpUIManaqer 



1 : new() 



^ 



2: enableCallNotification( ) 



-^ 



3: callEventNotify( 



4: 'forward event' 



5: new() 



-^D 



6: createUICalK ) 



8: sendlnfoAndCollectReq( ) 



7: new() 



-^ 



-^ 



r 



10: 'forward event' 



9: sendlnfoAndCollec 



:Res( ) 



1 1 : release( ) 



12:routeReq( ) 



^ 



14: 'forward event' 



13:routeRes( ) 



^ 



^ 



16: "forward event" 



15:callEnded( ) 



17:deassignCall( ) 



1 : This message is used by the appHcation to create an object implementing the IpAppCallControlManager interface. 

2: This message is sent by the appHcation to enable notifications on new call events. As this sequence diagram depicts 
a call barring service, it is likely that all new call events destined for a particular address or address range prompted for 
a password before the call is allowed to progress. When a new call, that matches the event criteria set, arrives a 
message (not shown) is directed to the object implementing the IpCallControlManager. Assuming that the criteria for 
creating an object implementing the IpCall interface (e.g. load control values not exceeded) is met, other messages (not 
shown) are used to create the call and associated call leg object. 

3: This message is used to pass the new call event to the object implementing the IpAppCallControlManager interface. 

4: This message is used to forward the previous message to the IpAppLogic. 

5: This message is used by the application to create an object implementing the IpAppCall interface. The reference to 
this object is passed back to the object implementing the IpCallControlManager using the return parameter of the 
callEventNotify. 

6: This message is used to create a new UlCall object. The reference to the call object is given when creating the 
UlCall. 

7: Provided all the criteria are fulfilled, a new UlCall object is created. 

8: The call barring service dialogue is invoked. 
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9: The result of the dialogue, which in this case is the PIN code, is returned to its callback object. 

10: This message is used to forward the previous message to the IpAppLogic. 

1 1 : This message releases the UlCall object. 

12: Assuming the correct PIN is entered, the call is forward routed to the destination party. 

13: This message passes the result of the call being answered to its callback object. 

14: This message is used to forward the previous message to the IpAppLogic 

15: When the call is terminated in the network, the application will receive a notification. This notification will always 
be received when the call is terminated by the network in a normal way, the application does not have to request this 
event explicitly. 

16: The event is forwarded to the application. 

17: The application must free the call related resources in the gateway by calling deassignCall. 



6.1 .5 Number Translation 1 

The following sequence diagram shows a simple number translation service, initiated as a result of a prearranged event 
being received by the framework. 
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: (Logical 
View::lpAppLoqic) 



: IpAppCallControlManaqer 



IpAppCall 



IpCallControlManaqer 



IpCall 



1 : new() 




1 : This message is used by the appHcation to create an object implementing the IpAppCallControlManager interface. 

2: This message is sent by the appHcation to enable notifications on new call events. As this sequence diagram depicts 
a number translation service, it is likely that only new call events within a certain address range will be enabled. When 
a new call, that matches the event criteria set in message 2, arrives a message (not shown) is directed to the object 
implementing the IpCallControlManager. Assuming that the criteria for creating an object implementing the IpCall 
interface (e.g. load control values not exceeded) is met, other messages (not shown) are used to create the call and 
associated call leg object. 

3: This message is used to pass the new call event to the object implementing the IpAppCallControlManager interface. 

4: This message is used to forward message 3 to the IpAppLogic. 
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5: This message is used by the application to create an object implementing the IpAppCall interface. The reference to 
this object is passed back to the object implementing the IpCallControlManager using the return parameter of message 

3. 

6: This message invokes the number translation function. 

7: The returned translated number is used in message 7 to route the call towards the destination. 

8: This message passes the result of the call being answered to its callback object 

9: This message is used to forward the previous message to the IpAppLogic. 

10: The application is no longer interested in controlling the call and therefore deassigns the call. The call will continue 
in the network, but there will be no further communication between the call object and the application. 



6.1.6 Number Translation 1 (with callbacks) 

The following sequence diagram shows a simple number translation service, initiated as a result of a prearranged event 
being received by the framework. 

For illustation, in this sequence the callback references are set explictly. This is optional. All the callbacks references 
can also be passed in other methods. From an efficiency point of view that is also the preferred method. The rest of the 
sequences use that mechanism. 
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: (Logical 
View::lpAppLoqic) 



: I pAppCallControl Manager 



IpAppCall 



IpCallControlManaqer 



: IpCall 



1 : new() 



^ 



2: enableCallNotification( 



3: setCallback( ) 



5: 'forward event' 



n^^ 



^^ 



4: callEventNotify( 



8: 'translate number' 



^ 



1 1 : 'forward event' 



n^^ 



6: new() 



^ 
^ 



^ 



7: setCallbackWithSes;;ionlD( ) 



9: routeReq( 



-^ 



-^ 



10: routeRes( 



^^ 



12: deassignC^al 



-^ 



1 : This message is used by the appHcation to create an object implementing the IpAppCallControlManager interface. 

2: This message is sent by the appHcation to enable notifications on new call events. As this sequence diagram depicts 
a number translation service, it is likely that only new call events within a certain address range will be enabled. When 
a new call, that matches the event criteria set in message 2, arrives a message (not shown) is directed to the object 
implementing the IpCallControlManager. Assuming that the criteria for creating an object implementing the IpCall 
interface (e.g. load control values not exceeded) is met, other messages (not shown) are used to create the call and 
associated call leg object. 
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3: This message sets the reference of the IpAppCallControlManager object in the CallControlManager. The 
CallControlManager reports the callEventNotify to referenced object only for enableCallNotification's that do not have 
a expHcit IpAppCallControlManager reference specified in the enableCallNotification. 

4: This message is used to pass the new call event to the object implementing the IpAppCallControlManager interface. 

5: This message is used to forward message 4 to the IpAppLogic. 

6: This message is used by the application to create an object implementing the IpAppCall interface. 

7: This message is used to set the reference to the IpAppCall for this call. 

8: This message invokes the number translation function. 

9: The returned translated number is used in message 7 to route the call towards the destination. 

10: This message passes the result of the call being answered to its callback object 

1 1: This message is used to forward the previous message to the IpAppLogic. 

12: The application is no longer interested in controlling the call and therefore deas signs the call. The call will continue 
in the network, but there will be no further communication between the call object and the application. 



6.1 .7 Number Translation 2 

The following sequence diagram shows a number translation service, initiated as a result of a prearranged event being 
received by the framework. If the translated number being routed to does not answer or is busy then the call is 
automatically released. 
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: (Logical 
View::lpAppLoqic) 



: IpAppCallControlManaqer 



: IpAppCall 



1 : new() 



^ 



2: enableCallNotification( ) 



3: callEventNotify( 



4: 'forward event' 



5: new() 



6: 'translate number' 



9: 'forward event' 



^ 



-^ 



7: routeReq( 



: IpCallControlManaqer 



: IpCall 



-^ 



-^ 



8: routeRes( ) 



10: release( 



^ 



1 : This message is used by the appHcation to create an object implementing the IpAppCallControlManager interface. 

2: This message is sent by the appHcation to enable notifications on new call events. As this sequence diagram depicts 
a number translation service, it is likely that only new call events within a certain address range will be enabled. When 
a new call, that matches the event criteria, arrives a message (not shown) is directed to the object implementing the 
IpCallControlManager. Assuming that the criteria for creating an object implementing the IpCall interface (e.g. load 
control values not exceeded) is met, other messages (not shown) are used to create the call and associated call leg 
object. 

3: This message is used to pass the new call event to the object implementing the IpAppCallControlManager interface. 

4: This message is used to forward the previous message to the IpAppLogic. 

5: This message is used by the application to create an object implementing the IpAppCall interface. The reference to 
this object is passed back to the object implementing the IpCallControlManager using the return parameter of the 
callEventNotify. 

6: This message invokes the number translation function. 

7: The returned translated number is used to route the call towards the destination. 

8: Assuming the called party is busy or does not answer, the object implementing the IpCall interface sends a callback 
in this message, indicating the unavailability of the called party. 
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9: This message is used to forward the previous message to the IpAppLogic. 
10: The appHcation takes the decision to release the call. 



6.1 .8 Number Translation 3 

The following sequence diagram shows a number translation service, initiated as a result of a prearranged event being 
received by the framework. If the translated number being routed to does not answer or is busy then the call is 
automatically routed to a voice mailbox. 
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: (Logical 
View::lpAppLoqic) 



: IpAppCallControlManaqer 



: IpAppCall 



: IpCallControlManaqer 



: IpCall 



1 : new() 



->r 



2: enableCa 



3: callEvertNotify( ) 



4: 'forward event' 



newO 



INotification( 



-^ 



^ 



6: 'translate number' 



^^ 



9: 'forwarc event' 



D^ 



10: 'translate number' 



^^ 



13: 'forward event' 



D^ 



7: roiJteReq( 



-^ 



8: routeRes( ) 



^ 



1 1 : routeReq( ) 



-^ 



12:routeRes( ) 



14: deassignCall( ) 



-^ 



1 : This message is used by the appHcation to create an object implementing the IpAppCallControlManager interface. 

2: This message is sent by the appHcation to enable notifications on new call events. As this sequence diagram depicts 
a number translation service, it is likely that only new call events within a certain address range will be enabled. When 
a new call, that matches the event criteria, arrives a message (not shown) is directed to the object implementing the 
IpCallControlManager. Assuming that the criteria for creating an object implementing the IpCall interface (e.g. load 
control values not exceeded) is met, other messages (not shown) are used to create the call and associated call leg 
object. 

3: This message is used to pass the new call event to the object implementing the IpAppCallControlManager interface. 
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4: This message is used to forward the previous message to the IpAppLogic. 

5: This message is used by the application to create an object implementing the IpAppCall interface. The reference to 
this object is passed back to the object implementing the IpCallControlManager using the return parameter of the 
callEventNotify. 

6: This message invokes the number translation function. 

7: The returned translated number is used to route the call towards the destination. 

8: Assuming the called party is busy or does not answer, the object implementing the IpCall interface sends a callback, 
indicating the unavailability of the called party. 

9: This message is used to forward the previous message to the IpAppLogic. 

10: The application takes the decision to translate the number, but this time the number is translated to a number 
belonging to a voice mailbox system. 

1 1 : This message routes the call towards the voice mailbox. 

12: This message passes the result of the call being answered to its callback object. 

13: This message is used to forward the previous message to the IpAppLogic. 

14: The application is no longer interested in controlling the call and therefore deassigns the call. The call will continue 
in the network, but there will be no further communication between the call object and the application. 



6.1 .9 Number Translation 4 

The following sequence diagram shows a number translation service, initiated as a result of a prearranged event being 
received by the framework. Before the call is routed to the translated number, the application requests for all call related 
information to be delivered back to the application on completion of the call. 
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: (Logical 
View::lpAppLoqic) 



: IpAppCallControlManaqer 



: IpAppCall 



1 : new() 



4: 'forward event' 



enableCallNotification( ) 



3: callEventNotify( 



new() 



^ 



6: 'translate number' 



^^ 



10: 'forward event' 



[f- 



12: "forwanJ event' 



[f- 



14: 'forward event' 



[f- 



7: getCalllnfoReq( 



8: rou:eReq( 



^ 



: IpCallControlManaqer 



: IpCall 



-^ 



-^ 



-^ 



9: routeRes( ) 



11 : callEnded( ) 



13:getCalllnfoRes( ) 



15: deassignCall( ) 



-^ 



1 : This message is used by the appHcation to create an object implementing the IpAppCallControlManager interface. 

2: This message is sent by the appHcation to enable notifications on new call events. As this sequence diagram depicts 
a number translation service, it is likely that only new call events within a certain address range will be enabled. When 
a new call, that matches the event criteria, arrives a message (not shown) is directed to the object implementing the 
IpCallControlManager. Assuming that the criteria for creating an object implementing the IpCall interface (e.g. load 
control values not exceeded) is met, other messages (not shown) are used to create the call and associated call leg 
object. 

3: This message is used to pass the new call event to the object implementing the IpAppCallControlManager interface. 

4: This message is used to forward the previous message to the IpAppLogic. 
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5: This message is used by the appHcation to create an object implementing the IpAppCall interface. The reference to 
this object is passed back to the object implementing the IpCallControlManager using the return parameter of the 
callEventNotify. 

6: This message invokes the number translation function. 

7: The application instructs the object implementing the IpCall interface to return all call related information once the 
call has been released. 

8: The returned translated number is used to route the call towards the destination. 

9: This message passes the result of the call being answered to its callback object. 

10: This message is used to forward the previous message to the IpAppLogic. 

1 1 : Towards the end of the call, when one of the parties disconnects, a message (not shown) is directed to the object 
implementing the IpCall. This causes an event, to be passed to the object implementing the IpAppCall object. 

12: This message is used to forward the previous message to the IpAppLogic. 

13: The application now waits for the call information to be sent. Now that the call has completed, the object 
implementing the IpCall interface passes the call information to its callback object. 

14: This message is used to forward the previous message to the IpAppLogic 

15: After the last information is received, the application deassigns the call. This will free the resources related to this 
call in the gateway. 



6.1.10 Number Translations 

The following sequence diagram shows a simple number translation service which contains a status check function, 
initiated as a result of a prearranged event being received. In the following sequence, when the application receives an 
incoming call, it checks the status of the user, and returns a busy code to the calling party. 



IpAppLogic 



: IpAppCallControlManaqer : IpAppCall 



: IpCallControlManager 



: IpCall 



1 : new() 



-^(J 



2: eiableGallNotification( ) 



4: 'forward event' 



r 



5: ne\AM 



^^ 



3: callEventNotify( ) 



i 



6: 'check status' 



-^ 



^r 



7: appropriate release cause 



-^ 
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1 : This message is used by the application to create an object implementing the IpAppCallControlManager interface. 

2: This message is sent by the application to enable notifications on new call events. As this sequence diagram depicts 
a number translation service, it is likely that only new call events within a certain address range will be enabled. 

When a new call, that matches the event criteria set in message 2, arrives a message (not shown) is directed to the object 
implementing the IpCallControlManager. Assuming that the criteria for creating an object implementing the IpCall 
interface (e.g. load control values not exceeded) is met, other messages (not shown) are used to create the call and 
associated call leg object. 

3: This message is used to pass the new call event to the object implementing the IpAppCallControlManager interface. 

4: This message is used to forward message 3 to the IpAppLogic. 

5: This message is used by the application to create an object implementing the IpAppCall interface. The reference to 
this object is passed back to the object implementing the IpCallControlManager using the return parameter of message 

3. 

6: This message invokes the status checking function. 

7: The application decides to release the call, and sends a release cause to the calling party indicating that the user is 
busy. 



6.1.11 Prepaid 

This sequence shows a Pre-paid application. 

The subscriber is using a pre-paid card or credit card to pay for the call. The application each time allows a certain 
timeslice for the call. After the timeslice, a new timeslice can be started or the application can terminate the call. In the 
following sequence the end-user will received an announcement before his final timeslice. 
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Prepaid : (Logical 
View::lpAppLoaic) 



: IpAppCall 



: IpAppCallControlManaqer 



: IpAppUICall 



: IpCall : IpCallControlManaqer 



new() 



[f- 



4: "forward event" 



9: "forward event" ^<^ 

[f 



12: "forward event" 

[f 



15: "forward event' 

[f 



[T 



23: "forward event: 



^ 



2: enableCallNotification( ) 



^- 



3: callEventNotify( ) 



5: new() 



6: superviseC;allReq( ) 
7: routeReq( ) 



8: superviseCallRes( ) 



10: superviseC;allReq( ) 



1 1 : superviseCallRes( ) 



13: superviseC;allReq( ) 



14: s;uperviseCallRes( ) 



19: "forward event" 



^ 



16:createUICall( ) 



17: sendlnfoReq( ) 



20: release( ) 



21: supervise3allReq( ) 

: s;uperviseCallRes( ) 



: IpUIManaqer 



: IpUICall 



^D 



18: sendlnfoRes( ) 



^ 



-^ 



1 : This message is used by the application to create an object implementing the IpAppGenericCallControlManager 
interface. 

2: This message is sent by the application to enable notifications on new call events. As this sequence diagram depicts 
a pre-paid service, it is likely that only new call events within a certain address range will be enabled. When a new call, 
that matches the event criteria, arrives a message (not shown) is directed to the object implementing the 
IpCallControlManager. Assuming that the criteria for creating an object implementing the IpCall interface (e.g. load 
control values not exceeded) is met, other messages (not shown) are used to create the call and associated call leg 
object. 
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3: The incoming call triggers the Pre-Paid Application (PPA). 

4: The message is forwarded to the application. 

5: A new object on the application side for the Generic Call object is created 

6: The Pre-Paid Application (PPA) requests to supervise the call. The application will be informed after the period 
indicated in the message. This period is related to the credits left on the account of the pre-paid subscriber. 

7: Before continuation of the call, PPA sends all charging information, a possible tariff switch time and the call 
duration supervision period, towards the GW which forwards it to the network. 

8: At the end of each supervision period the application is informed and a new period is started. 

9: The message is forwarded to the application. 

10: The Pre-Paid Application (PPA) requests to supervise the call for another call duration. 

1 1 : At the end of each supervision period the application is informed and a new period is started. 

12: The message is forwarded to the application. 

13: The Pre-Paid Application (PPA) requests to supervise the call for another call duration. 

14: When the user is almost out of credit an announcement is played to inform about this. The announcement is played 
only to the leg of the A-party, the B -party will not hear the announcement. 

15: The message is forwarded to the application. 

16: A new UlCall object is created and associated with the controlling leg. 

17: An announcement is played to the controlling leg informing the user about the near-expiration of his credit limit. 
The B -subscriber will not hear the announcement. 

18: When the announcement is completed the application is informed. 

19: The message is forwarded to the application. 

20: The application releases the UlCall object. 

21: The user does not terminate so the application terminates the call after the next supervision period. 

22: The supervision period ends 

23: The event is forwarded to the logic. 

24: The application terminates the call. Since the user interaction is already explicitly terminated no 
userlnteractionFaultDetected is sent to the application. 



6.1.12 Pre-Paid with Advice of Charge (AoC) 

This sequence shows a Pre-paid application that uses the Advice of Charge feature. 

The application will send the charging information before the actual call setup and when during the call the charging 
changes new information is sent in order to update the end-user. Note: the Advice of Charge feature requires an 
application in the end-user terminal to display the charges for the call, depending on the information received from the 
application. 
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Prepaid : (Logical : IpAppCallControlManaqer 

View::lpAppLoqic) 



IpAppCall : IpAppUICall : IpCallControlManaqer 



1 : new() 



^ 



4: "forward event" 



^ 



[f- 



[f- 



ir 



5: new() 



2: enableCallNotification( ) 



-^ 



3: callEventNotify( ) 



^ 



10: "forwarc event' 



13: "forwarc event' 



17: "forwarc event' 



18: new() 



23: "forward event' 



26: "forward event: 



6: setAdviceOfCharge( ) 



7: superviseCallReq( ) 



routeReq( ) 



9: superviseCallRes( ) 



1 1 : superviseCallReq( ) 



12: superviseCallRes( ) 
14: setAdviceOfCharge( ) 



15: superviseCallReq( ) 



16: superviseCallRes( ) 



-^ 



19:createUICall( ) 



21:sendlnfoReq( ) 



3 



22: sendlnfoRes( ) 



24: superviseCallReq( ) 



25: superviseCallRes( ) 



27: release( ) 



^ 



28: userlnteractionFau tDetected( ) 



: IpUIManaaer : IpUICall 



^ 20: new() 

"^ — >n 
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1 : This message is used by the application to create an object implementing the IpAppCallControlManager interface. 

2: This message is sent by the application to enable notifications on new call events. As this sequence diagram depicts 
a pre-paid service, it is likely that only new call events within a certain address range will be enabled. When a new call, 
that matches the event criteria, arrives a message (not shown) is directed to the object implementing the 
IpCallControlManager. Assuming that the criteria for creating an object implementing the IpCall interface (e.g. load 
control values not exceeded) is met, other messages (not shown) are used to create the call and associated call leg 
object. 

3: The incoming call triggers the Pre-Paid Application (PPA). 

4: The message is forwarded to the application. 

5: A new object on the application side for the Call object is created 

6: The Pre-Paid Application (PPA) sends the AoC information (e.g the tariff switch time), (it shall be noted the PPA 
contains ALL the tariff information and knows how to charge the user). 

During this call sequence 2 tariff changes take place. The call starts with tariff 1, and at the tariff switch time (e.g., 
18:00 hours) switches to tariff 2. The application is not informed about this (but the end-user is!) 

7: The Pre-Paid Application (PPA) requests to supervise the call. The application will be informed after the period 
indicated in the message. This period is related to the credits left on the account of the pre-paid subscriber. 

8: The application requests to route the call to the destination address. 

9: At the end of each supervision period the application is informed and a new period is started. 

10: The message is forwarded to the application. 

1 1 : The Pre-Paid Application (PPA) requests to supervise the call for another call duration. 

12: At the end of each supervision period the application is informed and a new period is started. 

13: The message is forwarded to the application. 

14: Before the next tariff switch (e.g., 19:00 hours) the application sends a new AOC with the tarif switch time. Again, 
at the tariff switch time,the network will send AoC information to the end-user. 

15: The Pre-Paid Application (PPA) requests to supervise the call for another call duration. 

16: When the user is almost out of credit an announcement is played to inform about this (19-21). The announcement is 
played only to the leg of the A-party, the B -party will not hear the announcement. 

17: The message is forwarded to the application. 

18: The application creates a new call back interface for the User interaction messages. 

19: A new UI Call object that will handle playing of the announcement needs to be created 

20: The Gateway creates a new UI call object that will handle playing of the announcement. 

21: With this message the announcement is played to the calling party. 

22: The user indicates that the call should continue. 

23: The message is forwarded to the application. 

24: The user does not terminate so the application terminates the call after the next supervision period. 

25: The user is out of credit and the application is informed. 

26: The message is forwarded to the application. 

27: With this message the application requests to release the call. 
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28: Terminating the call which has still a UlCall object associated will result in a userlnteractionFaultDetected. The 
UlCall object is terminated in the gateway and no further communication is possible between the UlCall and the 
application. 



6.2 Class Diagrams 



This class diagram shows the interfaces of the generic call control service package. 



«lnterface» 
IpService 
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Figure: Service Interfaces 

The generic call control service consists of two packages, one for the interfaces on the application side and one for 
interfaces on the service side. 

The class diagrams in the following figures show the interfaces that make up the generic call control application 
package and the generic call control service package. Communication between these packages is indicated with the 
«uses» associations; e.g., the IpCallControlManager interface uses the IpAppGenericCallControlManager , by 
means of calling callback methods. 

This class diagram shows the interfaces of the generic call control application package and their relations to the 
interfaces of the generic call control service package. 
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Iplnterface 



«lnterface» 

IpAppCallControlManage 

(from gees) 



^allAbortedO 
♦eallEventNotifyO 

I %)allNotifieationlnterrupted( 
%)allNotifieationContinued( 
^allOverloadEneountered( 
%)allOverloadCeased( 



«uses» 



«lnterfaee» 
IpCallControl ^ 



Manager 
(from gees) 



0..n 



«lnterfaee» 

IpAppCall 

(from gees) 



^outeResQ 

^outeErrO 

^etCalllnfoRes( 

^etCalllnfoErr( 
l%uperviseCallRes( 
|%uperviseCallErr( 
|%allFaultDeteeted() 
|^etMoreDialledDigitsRes( 
|^etMoreDialledDigitsErr( 
IJcallEndedO 



«uses» 



«lnterfaee» 
O-n ipCall 

(from gees) 



6.3 



Figure: Application Interfaces 



Generic Gall Gontrol Service Interface Glasses 



The Generic Call Control Service (GCCS) provides the basic call control service for the API. It is based around a third 
party model, which allows calls to be instantiated from the network and routed through the network. 

The GCCS supports enough functionality to allow call routing and call management for today's Intelligent Network 
(IN) services in the case of a switched telephony network, or equivalent for packet based networks. 
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It is the intention of the GCCS that it could be readily specialised into call control specifications, for example, ITU-T 
recommendations H.323, ISUP, Q.931 and Q.2931, ATM Forum specification UNI3.1 and the IETF Session Initiation 
Protocol, or any other call control technology. 

The adopted call model has the following objects. Note that not all of these concepts are used in the generic call. 

* a call object. A call is a relation between a number of parties. The call object relates to the entire call view from the 
application. E.g., the entire call will be released when a release is called on the call. Note that different applications can 
have different views on the same physical call, e.g., one application for the originating side and another application for 
the terminating side. The applications will not be aware of each other, all 'communication' between the applications will 
be by means of network signalling. The API currently does not specify any feature interaction mechanisms. 

* a call leg object. The leg object represents a logical association between a call and an address. The relationship 
includes at least the signalling relation with the party. The relation with the address is only made when the leg is routed. 
Before that the leg object is IDLE and not yet associated with the address. 

* an address. The address logically represents a party in the call. 

* a terminal. A terminal is the end-point of the signalling and/or media for a party. This object type is currently not 
addressed. 

The call object is used to establish a relation between a number of parties by creating a leg for each party within the 
call. 

Associated with the signalling relationship represented by the call leg, there may also be a bearer connection (e.g., in the 
traditional voice only networks) or a number (zero or more) of media channels (in multi-media networks). 

A leg can be attached to the call or detached from the call. When the leg is attached, this means that media or bearer 
channels related to the legs are connected to the media or bearer channels of the other legs that are attached to the same 
call. I.e., only legs that are attached can 'speak' to each other. A leg can have a number of states, depending on the 
signalling received from or sent to the party associated with the leg. Usually there is a limit to the number of legs that 
are in being routed (i.e., the connection is being established) or connected to the call (i.e., the connection is established). 
Also, there usually is a limit to the number of legs that can be simultaneously attached to the same call. 

Some networks distinguish between controlling and passive legs. By definition the call will be released when the 
controlling leg is released. All other legs are called passive legs. There can be at most one controlling leg per call. 
However, there is currently no way the application can influence whether a Leg is controlling or not. 

There are two ways for an application to get the control of a call. The application can request to be notified of calls that 
meet certain criteria. When a call occurs in the network that meets these criteria, the application is notified and can 
control the call. Some legs will already be associated with the call in this case. Another way is to create a new call from 
the application. 

For the generic call control service, only a subset of the model is used; the API for generic call control does not give 
explicit access to the legs and the media channels. This is provided by the Multi-Party Call Control Service. 
Furthermore, the generic call is restricted to two party calls, i.e., only two legs are active at any given time. Active is 
defined here as 'being routed' or connected. 

The GCCS is represented by the IpCallManager and IpCall interfaces that interface to services provided by the network. 
Some methods are asynchronous, in that they do not lock a thread into waiting whilst a transaction performs. In this 
way, the client machine can handle many more calls, than one that uses synchronous message calls. To handle 
responses and reports, the developer must implement IpAppCallManager and IpAppCall to provide the callback 
mechanism. 

6.3.1 Interface Class IpCallControlManager 

Inherits from: Ip Service 

This interface is the 'service manager' interface for the Generic Call Control Service. The generic call control manager 
interface provides the management functions to the generic call control service. The application programmer can use 
this interface to provide overload control functionality, create call objects and to enable or disable call-related event 
notifications. 



ETSI 



3GPP TS 29.198-4 version 4.1.0 Release 4 35 ETSI TS 129 198-4 V4.1.0 (2001-09) 



«lnterface» 
IpCallControlManager 



createCall (appCall : in IpAppCallRef) : TpCallldentifier 

enableCallNotification (appCallControlManager : in IpAppCallControlManagerRef, eventCriteria : in 
TpCallEventCriteria) : TpAssignmentID 

disableCallNotification (assignmentID : in TpAssignmentID) : void 

setCallLoadControl (duration : in TpDuration, mechanism : in TpCallLoadControlMechanism, treatment : in 
TpCallTreatment, addressRange : in TpAddressRange) : TpAssignmentID 

changeCallNotification (assignmentID : in TpAssignmentID, eventCriteria : in TpCallEventCriteria) : void 

getCriteria () : TpCallEventCriteriaResultSet 



Method 
createCall () 

This method is used to create a new call object. An Ip AppCallControlManager should already have been passed to the 
IpCallControlManager, otherwise the call control will not be able to report a callAborted() 

to the application (the application should invoke setCallback() if it wishes to ensure this). 

Returns callReference: Specifies the interface reference and sessionID of the call created. 

Parameters 

appCall : in IpAppCallRef 

Specifies the application interface for callbacks from the call created. 

Returns 
TpCallldentifier 

Raises 

TpCommonExceptions , P_INVALID_INTERFACE_TYPE 



Method 
enableCallNotification ( ) 

This method is used to enable call notifications so that events can be sent to the application. This is the first step an 
application has to do to get initial notification of calls happening in the network. When such an event happens, the 
application will be informed by callEventNotify(). In case the application is interested in other events during the context 
of a particular call session it has to use the routeReqO method on the call object. The application will get access to the 
call object when it receives the callEventNotify(). (Note that the enableCallNotification() is not applicable if the call is 
setup by the application). 

The enableCallNotification method is purely intended for applications to indicate their interest to be notified when 
certain call events take place. It is possible to subscribe to a certain event for a whole range of addresses, e.g. the 
application can indicate it wishes to be informed when a call is made to any number starting with 800. 
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If some application already requested notifications with criteria that overlap the specified criteria, the request is refused 
with P_GCCS_INVALID_CRITERIA.The criteria are said to overlap if both originating and terminating ranges overlap 
and the same number plan is used and the same CallNotificationType is used. 

If a notification is requested by an application with the monitor mode set to notify, then there is no need to check the 
rest of the criteria for overlapping with any existing request as the notify mode does not allow control on a call to be 
passed over. Only one application can place an interrupt request if the criteria overlaps. 

If the same application requests two notifications with exactly the same criteria but different callback references, the 
second callback will be treated as an additional callback. Both notifications will share the same assignmentlD. The 
gateway will always use the most recent callback. In case this most recent callback fails the second most recent is used. 
In case the enableCallNotification contains no callback, at the moment the application needs to be informed the gateway 
will use as callback the callback that has been registered by setCallBack(). 

Returns assignmentlD: Specifies the ID assigned by the generic call control manager interface for this newly-enabled 
event notification. 

Parameters 

appCallControlManager : in IpAppCallControlManagerRef 

If this parameter is set (i.e. not NULL) it specifies a reference to the application interface, which is used for callbacks. If 
set to NULL, the application interface defaults to the interface specified via the setCallback() method. 

eventCriteria : in TpCallEventCriteria 

Specifies the event specific criteria used by the application to define the event required. Only events that meet these 
criteria are reported. Examples of events are "incoming call attempt reported by network", "answer", "no answer", 
"busy" . Individual addresses or address ranges may be specified for destination and/or origination. 

Returns 

TpAs s ignment ID 

Raises 

TpCommonExceptions, P_INVALID_CRITERIA, P_INVALID_INTERFACE_TYPE, 
P INVALID EVENT TYPE 



Method 
disableCallNotification () 

This method is used by the application to disable call notifications. 

Parameters 

assignmentlD : in TpAss ignment ID 

Specifies the assignment ID given by the generic call control manager interface when the previous enableNotification() 
was called. If the assignment ID does not correspond to one of the valid assignment IDs, the framework will return the 
error code P_INVALID_ASSIGNMENTID. If two callbacks have been registered under this assignment ID both of 
them will be disabled. 

Raises 

TpCommonExceptions , P_INVALID_ASSIGNMENT_ID 



Method 
setCallLoadControl () 
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This method imposes or removes load control on calls made to a particular address range within the generic call control 
service. The address matching mechanism is similar as defined for TpCallEventCriteria. 

Returns assignmentID: Specifies the assignmentID assigned by the gateway to this request. This assignementID can be 
used to correlate the callOverlloadEncountered and callOverloadCeased methods with the request. 

Parameters 

duration : in TpDuration 

Specifies the duration for which the load control should be set. 

A duration of indicates that the load control should be removed. 

A duration of -1 indicates an infinite duration (i.e., until disabled by the application) 

A duration of -2 indicates the network default duration. 

mechanism : in TpCallLoadControlMechanism 

Specifies the load control mechanism to use (for example, admit one call per interval), and any necessary parameters, 
such as the call admission rate. The contents of this parameter are ignored if the load control duration is set to zero. 

treatment : in TpCallTreatment 

Specifies the treatment of calls that are not admitted. The contents of this parameter are ignored if the load control 
duration is set to zero. 

addressRange : in TpAddressRange 

Specifies the address or address range to which the overload control should be applied or removed. 

Returns 

TpAs s ignment ID 

Raises 

TpCommonExceptions, P_INVALID_ADDRESS, P_UNSUPPORTED_ADDRESS_PLAN 



Method 
changeCallNotif ication ( ) 

This method is used by the application to change the event criteria introduced with enableCallNotification. Any stored 
criteria associated with the specified assignementID will be replaced with the specified criteria. 

Parameters 

assignmentID : in TpAss ignment ID 

Specifies the ID assigned by the generic call control manager interface for the event notification. If two call backs have 
been registered under this assignment ID both of them will be changed. 

eventCriteria : in TpCallEventCriteria 

Specifies the new set of event specific criteria used by the application to define the event required. Only events that 
meet these criteria are reported. 
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Raises 

TpCommonExceptions, P_INVALID_ASSIGNMENT_ID, P_INVALID_CRITERIA, 
P INVALID EVENT TYPE 



Method 
getCriteria () 

This method is used by the appHcation to query the event criteria set with enableCallNotification or 
changeCallNotification. 

Returns eventCriteria: Specifies the event specific criteria used by the appHcation to define the event required. Only 
events that meet these criteria are reported. 

Parameters 

No Parameters were identified for this method 

Returns 
TpCallEventCriteriaResultSet 

Raises 
TpCommonExceptions 



6.3.2 Interface Class IpAppCallControlManager 

Inherits from: Iplnterface 

The generic call control manager application interface provides the application call control management functions to the 
generic call control service. 



«lnterface» 
IpAppCallControlManager 



callAborted (callReference : in TpSessionID) : void 

callEventNotify (callReference : in TpCallldentifier, eventlnfo : in TpCallEventlnfo, assignmentID : in 
TpAssignmentID) : IpAppCallRef 

callNotificationlnterrupted () : void 

callNotificationContinued () : void 

callOverloadEncountered (assignmentID : in TpAssignmentID) : void 

callOverloadCeased (assignmentID : in TpAssignmentID) : void 



Method 
callAborted ( ) 

This method indicates to the application that the call object (at the gateway) has aborted or terminated abnormally. No 
further communication will be possible between the call and application. 
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Parameters 

callReference : in TpSessionID 

Specifies the sessionID of call that has aborted or terminated abnormally. 



Method 

callEventNotif y ( ) 

This method notifies the application of the arrival of a call-related event. 

If this method is invoked with a monitor mode of P_MONITOR_MODE_INTERRUPTED, then the APL has control of 
the call. If the APL does nothing with the call (including its associated legs) within a specified time period (the duration 
of which forms a part of the service level agreement), then the call in the network shall be released and callEnded() 
shall be invoked, giving a release cause of 102 (Recovery on timer expiry). 

When this method is invoked with a monitor mode of P_MONITOR_MODE_INTERRUPT, the application writer 
should ensure that no routeReqO is performed until an IpAppCall has been passed to the gateway, either through an 
explicit setCallbackO invocation on the supplied IpCall, or via the return of the callEventNotifyO method. 

Returns appCall: Specifies a reference to the application interface which implements the callback interface for the new 
call. This parameter will be null if the notification is in NOTIFY mode. 

Parameters 

callReference : in TpCallldentif ier 

Specifies the reference to the call interface to which the notification relates. This parameter will be null if the 
notification is in NOTIFY mode. 

event Info : in TpCallEventlnfo 

Specifies data associated with this event. 

assignment ID : in TpAssignmentID 

Specifies the assignment id which was returned by the enableNotification() method. The application can use assignment 
id to associate events with event specific criteria and to act accordingly. 

Returns 
IpAppCallRef 



Method 
callNotif icationlnterrupted ( ) 

This method indicates to the application that all event notifications have been temporary interrupted (for example, due 
to faults detected). 

Note that more permanent failures are reported via the Framework (integrity management). 

Parameters 

No Parameters were identified for this method 



Method 

callNotif icationContinued ( ) 

This method indicates to the application that event notifications will again be possible. 
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Parameters 

No Parameters were identified for this method 



Method 

callOverloadEncountered ( ) 

This method indicates that the network has detected overload and may have automatically imposed load control on calls 
requested to a particular address range or calls made to a particular destination within the call control service. 

Parameters 

assignment ID : in TpAssignmentID 

Specifies the assignmentID corresponding to the associated setCallLoadControl. This implies the addressrange for 
within which the overload has been encountered. 



Method 

callOverloadCeased ( ) 

This method indicates that the network has detected that the overload has ceased and has automatically removed any 
load controls on calls requested to a particular address range or calls made to a particular destination within the call 
control service. 

Parameters 

assignmentID : in TpAssignmentID 

Specifies the assignmentID corresponding to the associated setCallLoadControl. This implies the addressrange for 
within which the overload has been ceased 



6.3.3 Interface Class IpCall 

Inherits from: IpService 

The generic Call provides the possibility to control the call routing, to request information from the call, control the 
charging of the call, to release the call and to supervise the call. It does not give the possibility to control the legs 
directly and it does not allow control over the media. The first capability is provided by the multi-party call and the 
latter as well by the multi-media call. The call is limited to two party calls, although it is possible to provide 'follow-on' 
calls, meaning that the call can be rerouted after the terminating party has disconnected or routing to the terminating 
party has failed. Basically, this means that at most two legs can be in connected or routing state at any time. 




routeReq (callSessionID : in TpSessionID, responseRequested : in TpCallReportRequestSet, targetAddress 
: in TpAddress, originatingAddress : in TpAddress, originalDestinationAddress : in TpAddress, 
redirectingAddress : in TpAddress, applnfo : in TpCallApplnfoSet) : TpSessionID 

release (callSessionID : in TpSessionID, cause : in TpCallReleaseCause) : void 

deassignCall (callSessionID : in TpSessionID) : void 

getCalllnfoReq (callSessionID : in TpSessionID, calllnfoRequested : in TpCalllnfoType) : void 



ETSI 



3GPP TS 29.198-4 version 4.1.0 Release 4 41 ETSI TS 129 198-4 V4.1.0 (2001-09) 



setCallChargePlan (callSessionID : in TpSessionID, callChargePlan : in TpCallChargePlan) : void 

setAdviceOfCharge (callSessionID : in TpSessionID, aOCInfo : in TpAoClnfo, tariffSwitch : in TpDuration) : 
void 

getMoreDialledDigitsReq (callSessionID : in TpSessionID, length : in Tplnt32) : void 

superviseCallReq (callSessionID : in TpSessionID, time : in TpDuration, treatment : in 
TpCallSuperviseTreatment) : void 



Method 
routeReq ( ) 

This asynchronous method requests routing of the call to the remote party indicated by the target Address. 

The extra address information such as originating Address is optional. If not present (i.e., the plan is set to 
P_ADDRESS_PLAN_NOT_PRESENT), the information provided in corresponding addresses from the route is used, 
otherwise the network or gateway provided numbers will be used. 

If this method in invoked, and call reports have been requested, yet no IpAppCall interface has been provided, this 
method shall throw the P_NO_CALLB ACK_ADDRESS_SET exception. 

Returns callLegSessionID: Specifies the sessionID assigned by the gateway. This is the sessionID of the implicitly 
created call leg. The same ID will be returned in the routeRes or Err. This allows the application to correlate the request 
and the result. 

This parameter is only relevant when multiple routeReqO calls are executed in parallel, e.g., in the multi-party call 
control service. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

responseRequested : in TpCallReportRequestSet 

Specifies the set of observed events that will result in zero or more routeRes() being generated. 

E.g., when both answer and disconnect is monitored the result can be received two times. 
If the application wants to control the call (in whatever sense) it shall enable event reports 

target Address : in TpAddress 

Specifies the destination party to which the call leg should be routed. 

originatingAddress : in TpAddress 

Specifies the address of the originating (calling) party. 

originalDestinationAddress : in TpAddress 

Specifies the original destination address of the call. 

redirectingAddress : in TpAddress 

Specifies the address from which the call was last redirected. 

applnfo : in TpCallAppInfoSet 

Specifies application-related information pertinent to the call (such as alerting method, tele-service type, service 
identities and interaction indicators). 
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Returns 
TpSessionID 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_ADDRESS, 
P_UNSUPPORTED_ADDRESS_PLAN, P_INVALID_NETWORK_STATE, P_INVALID_CRITERIA, 
P INVALID EVENT TYPE 



Method 
release () 

This method requests the release of the call object and associated objects. The call will also be terminated in the 
network. If the application requested reports to be sent at the end of the call (e.g., by means of getCalllnfoReq) these 
reports will still be sent to the application. 

The application should always either release or deassign the call when it is finished with the call, unless a 
callFaultDetected is received by the application. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

cause : in TpCallReleaseCause 

Specifies the cause of the release. 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_NETWORK_STATE 



Method 
deassignCall () 

This method requests that the relationship between the application and the call and associated objects be de-assigned. It 
leaves the call in progress, however, it purges the specified call object so that the application has no further control of 
call processing. If a call is de-assigned that has event reports, call information reports or call Leg information reports 
requested, then these reports will be disabled and any related information discarded. 

The application should always either release or deassign the call when it is finished with the call, unless 
callFaultDetected is received by the application. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
getCalllnfoReq ( ) 
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This asynchronous method requests information associated with the call to be provided at the appropriate time (for 
example, to calculate charging). This method must be invoked before the call is routed to a target address. 

A report is received when the destination leg or party terminates or when the call ends. The call object will exist after 
the call is ended if information is required to be sent to the application at the end of the call. In case the originating party 
is still available the application can still initiate a follow-on call using routeReq. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

calllnfoRequested : in TpCalllnfoType 

Specifies the call information that is requested. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
setCallChargePlan ( ) 

Set an operator specific charge plan for the call. The charge plan must be set before the call is routed to a target address. 
Depending on the operator the method can also be used to change the charge plan for ongoing calls. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

callChargePlan : in TpCallChargePlan 

Specifies the charge plan to use. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
setAdviceOf Charge ( ) 

This method allows for advice of charge (AOC) information to be sent to terminals that are capable of receiving this 
information. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

aOCInfo : in TpAoCInfo 

Specifies two sets of Advice of Charge parameter. 

tariffSwitch : in TpDuration 

Specifies the tariff switch interval that signifies when the second set of AoC parameters becomes valid. 
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Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
getMoreDialledDigitsReq ( ) 

This asynchronous method requests the call control service to collect further digits and return them to the application. 
Depending on the administered data, the network may indicate a new call to the gateway if a caller goes off-hook or 
dialled only a few digits. The application then gets a new call event which contains no digits or only the few dialled 
digits in the event data. 

The application should use this method if it requires more dialled digits, e.g. to perform screening. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

length : in Tplnt32 

Specifies the maximum number of digits to collect. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
superviseCallReq ( ) 

The application calls this method to supervise a call. The application can set a granted connection time for this call. If 
an application calls this function before it calls a routeReqO or a user interaction function the time measurement will 
start as soon as the call is answered by the B -party or the user interaction system. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

time : in TpDuration 

Specifies the granted time in milliseconds for the connection. 

treatment : in TpCallSuperviseTreatment 

Specifies how the network should react after the granted connection time expired. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



6.3.4 Interface Class IpAppCall 

Inherits from: Iplnterface 

The generic call application interface is implemented by the client application developer and is used to handle call 
request responses and state reports. 
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«lnterface» 
IpAppCall 



routeRes (callSessionID : in TpSessionID, eventReport : in TpCallReport, callLegSessionID : in 
TpSessionID) : void 

routeErr (callSessionID : in TpSessionID, errorlndication : in TpCallError, callLegSessionID : in 
TpSessionID) : void 

getCalllnfoRes (callSessionID : in TpSessionID, calllnfoReport : in TpCalllnfoReport) : void 

getCalllnfoErr (callSessionID : in TpSessionID, errorlndication : in TpCallError) : void 

superviseCallRes (callSessionID : in TpSessionID, report : in TpCallSuperviseReport, usedTime : in 
TpDuration) : void 

superviseCallErr (callSessionID : in TpSessionID, errorlndication : in TpCallError) : void 

callFaultDetected (callSessionID : in TpSessionID, fault : in TpCallFault) : void 

getMoreDialledDigitsRes (callSessionID : in TpSessionID, digits : in TpString) : void 

getMoreDialledDigitsErr (callSessionID : in TpSessionID, errorlndication : in TpCallError) : void 

callEnded (callSessionID : in TpSessionID, report : in TpCallEndedReport) : void 



Method 
routeRes () 

This asynchronous method indicates that the request to route the call to the destination was successful, and indicates the 
response of the destination party (for example, the call was answered, not answered, refused due to busy, etc.). 

If this method is invoked with a monitor mode of P_MONITOR_MODE_INTERRUPTED, 

then the APL has control of the call. If the APL does nothing with the call (including its associated legs) within a 
specified time period (the duration of which forms a part of the service level agreement), then the call in the network 
shall be released and callEnded() shall be invoked, giving a release cause of 102 (Recovery on timer expiry). 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

eventReport : in TpCallReport 

Specifies the result of the request to route the call to the destination party. It also includes the network event, date and 
time, monitoring mode and event specific information such as release cause. 

callLegSessionID : in TpSessionID 

Specifies the sessionID of the associated call leg. This corresponds to the sesion ID returned at the routeReqO and can 
be used to correlate the response with the request. 



Method 
routeErr ( ) 
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This asynchronous method indicates that the request to route the call to the destination party was unsuccessful - the call 
could not be routed to the destination party (for example, the network was unable to route the call, the parameters were 
incorrect, the request was refused, etc.). 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

errorlndication : in TpCallError 

Specifies the error which led to the original request failing. 

callLegSessionID : in TpSessionID 

Specifies the sessionID of the associated call leg. This corresponds to the sessionID returned at the routeReqO and can 
be used to correlate the error with the request. 



Method 

getCalllnfoRes () 

This asynchronous method reports time information of the finished call or call attempt as well as release cause 
depending on which information has been requested by getCalllnfoReq. This information may be used e.g. for charging 
purposes. The call information will possibly be sent after routeRes in all cases where the call or a leg of the call has 
been disconnected or a routing failure has been encountered. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

calllnfoReport : in TpCalllnfoReport 

Specifies the call information requested. 



Method 
getCallInf oErr ( ) 

This asynchronous method reports that the original request was erroneous, or resulted in an error condition. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

errorlndication : in TpCallError 

Specifies the error which led to the original request failing. 



Method 

superviseCallRes () 

This asynchronous method reports a call supervision event to the application when it has indicated it's interest in these 
kind of events. 
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It is also called when the connection is terminated before the supervision event occurs. Furthermore, this method is 
invoked as a response to the request also when a tariff switch happens in the network during an active call. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call 

report : in TpCallSuperviseReport 

Specifies the situation which triggered the sending of the call supervision response. 

usedTime : in TpDuration 

Specifies the used time for the call supervision (in milliseconds). 



Method 
superviseCallErr ( ) 

This asynchronous method reports a call supervision error to the application. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

errorlndication : in TpCallError 

Specifies the error which led to the original request failing. 



Method 

callFaultDetected ( ) 

This method indicates to the application that a fault in the network has been detected. The call may or may not have 
been terminated. 

The system deletes the call object. Therefore, the application has no further control of call processing. No report will be 
forwarded to the application. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call in which the fault has been detected. 

fault : in TpCallFault 

Specifies the fault that has been detected. 



Method 
getMoreDialledDigitsRes () 

This asynchronous method returns the collected digits to the application. 
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Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

digits : in TpString 

Specifies the additional dialled digits if the string length is greater than zero. 



Method 
getMoreDialledDigitsErr ( ) 

This asynchronous method reports an error in collecting digits to the application. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 



errorlndication : in TpCallError 

Specifies the error which led to the original request failing. 



Method 
callEndedO 

This method indicates to the application that the call has terminated in the network. However, the application may still 
receive some results (e.g., getCalllnfoRes) related to the call. The application is expected to deassign the call object 
after having received the callEnded. 

Note that the event that caused the call to end might also be received separately if the application was monitoring for it. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call sessionlD. 

report : in TpCallEndedReport 

Specifies the reason the call is terminated. 

6.4 Generic Call Control Service State Transition Diagrams 
6.4.1 State Transition Diagrams for IpCallControlManager 

The state transition diagram shows the application view on the Call Control Manager object. 
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"a call object has terminated abnormally" ^IpAppCallControlManager.callAborted 

disableCallNotificatipfiA "arrival of call related event"[ notification active for this call event ] / 
enableCallNotificatibn \ ^^^^^^ ^ ^^" °^J®^* ^IpAppCallControlManager.callEventNotify 
I \|/createCall / create a Call object 
"new" f Active 



Creation of 
CallControlManager 
by Service Factory 



"notifications not possible" 
IpApptlallControlManager.callNotificationlnterrupted 



"notifications possible again" 
^IpAppCallControlManager.callNptificationContii^ued 




IpAccess.terminateServiceAgreement 



/\ 



disableCallNotification 

"a call object has terminated abnormally" 

^IpAppCallControlManager.callAborted 




IpAccess.terminateServiceAgreement 



Figure : Application view on the Call Control Manager 

6.4.1.1 Active State 

In this state a relation between the AppHcation and the Generic Call Control Service has been established. The state 
allows the applicatoin to indicate that it is interested in call related events. In case such an event occurs, the Call Control 
Manager will create a Call object and inform the application by invoking the operation callEventNotifyO on the 
IpAppCallControlManager interface. The application can also indicate it is no longer interested in certain call related 
events by calling disableCallNotification(). 

6.4.1 .2 Notification terminated State 

When the Call Control Manager is in the Notification terminated state, events requested with enableCallNotification() 
will not be forwarded to the application. There can be multiple reasons for this: for instance it might be that the 
application receives more notifications from the network than defined in the Service Level Agreement. Another 
example is that the Service has detected it receives no notifications from the network due to e.g. a link failure. In this 
state no requests for new notifications will be accepted. 

6.4.2 State Transition Diagrams for IpCall 

The state transition diagram shows the application view on the Call object. This diagram shows only the part of the state 
transition diagram valid for 3 GPP (UMTS) release 99. 
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setAdviceOfCharge 
superviseCallReq 




monitor mode = 
f^etCalllnfoRes, 



"connection to called party 
unsuccessful! monitor mode = interrupt 

"routeRes 
"routing aborted or invalid address" "routeErr 




"call ends : calling party disconnects" "callEnded 
"call ends: caMfng party abandoned" "callEnded 

"call ends : called party disconnects"! moflitor for this event ] "callEnded, routeRes(party 
"call ends: calling party disconnects"! no monitor for this event ] "callEnded 

"fault detected"! fault cannot be cormfiunicated with network event ] "callFaultDetected 



Network Released 



lO reports requestaa with gotCallmfoReq At 
supwviseCallReq 




timeout '*callFaultDetected("timeout on 



information ready" 
iperviseCallRes 



In state No Parties and Finished, a timer 
should prevent the object from occupuing 
resources. 

Upon expiry of this timer, callEnded() should 
be invoked with a release cause of 1 02 
(Recovery on timer expiry). In case when no 
IpAppCall is available on which to invoke 
callEndedO, callAborted() shall be invoked 
on the IpAppCallControlManager as this is 
an abnormal termination 



Figure : 3GPP 



6.4.2.1 Network Released State 



In this state the call has ended and the Gateway collects the possible call information requested with getCalllnfoReqO 
and / or superviseCallReq(). The information will be returned to the application by invoking the methods 
getCalllnfoResO and / or superviseCallRes() on the application. Also when a call was unsuccessful these methods are 
used.In case the application has not requested additional call related information immediately a transition is made to 
state Finished. 

6.4.2.2 Finished State 

In this state the call has ended and no call related information is to be send to the application. The application can only 
release the call object. Calling the deassignCall() operation has the same effect. Note that the application has to release 
the object itself as good 00 practice requires that when an object was created on behalf of a certain entity, this entity is 
also responsible for destroying it when the object is no longer needed. 

6.4.2.3 Application Released State 

In this state the application has requested to release the Call object and the Gateway collects the possilbe call 
information requested with getCalllnfoReqO and / or superviseCallReq(). In case the application has not requested 
additional call related information the Call object is destroyed immediately. 
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6.4.2.4 Active State 

In this state a call between two parties is being setup or present. Refer to the substates for more details. The application 
can request supervision of the call by calling superviseCallReq(). It is also allowed to send Advice of Charge 
information by calling setAdviceOfCharge() as well as to define the charging by invoking setCallChargePlan.. 

6.4.2.5 1 Party in Call State 

When the Call is in this state a calling party is present. The application can now request that a connection to a called 
party be established by calling the method routeReq(). 

In this state the application can also request the gateway for a certain type of charging of the call by calling 
setCallChargePlan(). The application can also request for charging related information by calling getCallInfoReq(). The 
setCallChargePlanO and getCalllnfoReqO should be issued before requesting a connection to a called party by means of 
routeReqO. 

When the calling party abandons the call before the application has invoked the routeReqO operation, the gateway 
informs the application by invoking callFaultDetected() and also the operation callEnded() will be invoked. When the 
calling party abandons the call after the application has invoked routeReqO but before the call has actually been 
established, the gateway informs the application by invoking callEnded(). 

When the called party answers the call, a transition will be made to the 2 Parties in Call state. In case the call can not be 
established because the application supplied an invalid address or the connection to the called party was unsuccessful 
while the application was monitoring for the latter in interrupt mode, the Call object will stay in this state 

In this state user interaction is possible unless there is an outstanding routing request. 

6.4.2.6 2 Parties in Call State 

A connection between two parties has been established. 

In case the calling party disconnects, the gateway informs the application by invoking callEnded(). 

When the called party disconnects different situations apply: 

1. the application is monitoring for this event in interrupt mode: a transition is made to the 1 Party in Call state, the 
application is informed with routeRes with indication that the called party has disconnected and all requested reports are 
sent to the application. The application now again has control of the call. 

2. the application is monitoring for this event but not in interrupt mode. In this case a transition is made to the Network 
Released state and the gateway informs the application by invoking the operation routeRes() and callEnded(). 

3. the application is not monitoring for this event. In this case the application is informed by the gateway invoking the 
callEndedO operation and a transition is made to the Network Released state. 

In this state user interaction is possible, depending on the underlying network. 
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6.5 Generic Call Control Service Properties 
6.5.1 List of Service Properties 

The following table lists properties relevant for the GCC API. 



Property 


Type 


Description / Interpretation 


P_TRIGGERING_EVENT_TYPES 


INTEGER_SET 


Indicates the static event types supported by the SCS. Static events are the events by 
which appHcations are initiated. 


P_DYNAMIC_EVENT_TYPES 


INTEGER_SET 


Indicates the dynamic event types supported by the SCS. Dynamic events are the events 
the appHcation can request for during the context of a call. 


P_ADDRESSPLAN 


INTEGER_SET 


Indicates the supported address plan (defined in TpAddressPlan.) e.g. 
{ P_ ADDRES S_PLAN_E 1 64, P_ ADDRES S_PLAN_IP } ) 


P_UI_CALL_BASED 


BOOLEAN_SET 


Value = TRUE : User interaction can be performed on call level and a reference to a Call 
object can be used in the IpUIManager.createUICall() operation. 

Value = FALSE: No User interaction on call level is supported. 


P_UI_AT_ALL_STAGES 


BOOLEAN_SET 


Value = TRUE: User Interaction can be performed at any stage during a call . 

Value = FALSE: User Interaction can be performed in case there is only one party in the 
call. 


P_MEDIA_TYPE 


INTEGER_SET 


Specifies the media type used by the Service. Values are defined by data-type 
TpMediaType : P_AUDIO, P_VIDEO, P_DATA 



The previous table lists properties related to capabilities of the SCS itself. The following table lists properties that are 
used in the context of the Service Level Agreement, e.g. to restrict the access of applications to the capabilities of the 
SCS. 



Property 


Type 


Description 


P_TRIGGERING_ ADDRESSES 


ADDRESS_RANGE_SET 


Indicates for which numbers the notification may be set. For terminating 
notifications it appHes to the terminating number, for originating 
notifications it applies only to the originating number. 


P_NOTIFICATION_TYPES 


INTEGER_SET 


Indicates whether the application is allowed to set originating and/or 
terminating triggers in the ECN. Set is: 

P_ORIGINATING 

P_TERMINATING 


P_MONITOR_MODE 


INTEGER_SET 


Indicates whether the application is allowed to monitor in interrupt and/or 
notify mode. Set is: 

P_INTERRUPT 

P_NOTIFY 


P_NUMBERS_TO_BE_CHANGED 


INTEGER_SET 


Indicates which numbers the application is allowed to change or fill for 
legs in an incoming call. Allowed value set: 

{P_ORIGINAL_CALLED_PARTY_NUMBER, 

P_REDIRECTING_NUMBER, 

P_TARGET_NUMBER, 

P_CALLING_PARTY_NUMBER}. 


P_CHARGEPLAN_ALLOWED 


INTEGER_SET 


Indicates which charging is allowed in the setCallChargePlan indicator. 
Allowed values: 

{ P_CHARGE_PER_TIME, 

P_TRANSPARANT_CHARGING, 

P_CHARGE_PLAN} 


P_CHARGEPLAN_MAPPING 


INTEGER_INTEGER_MAP 


Indicates the mapping of chargeplans (we assume they can be indicated 
with integers) to a logical network chargeplan indicator. When the 
chargeplan supports indicates P_CHARGE_PLAN then only chargeplans 
in this mapping are allowed. 



6.5.2 Service Property values for the CAMEL Service Environment. 

Implementations of the Generic Call Control API relying on the CSE shall have the Service Properties outlined above 
set to the indicated values : 
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P_OPERATION_SET = { 

'^IpCallControlManager . enableCallNotif ication'', 

'^IpCallControlManager . disableCallNotif ication" 

'^IpCallControlManager . changeCallNotif ication'', 

'^IpCallControlManager . getCriteria'', 

'^IpCallControlManager . setCallLoadControl'', 

"''IpCall . routeReq'', 

'^IpCall . release'', 

'^IpCall . deassignCall'', 

''IpCall .getCalllnfoReq'', 

''IpCall . setCallChargePlan'', 

''IpCall . setAdviceOfCharge'^ 

'^IpCall . superviseCallReq'', 



P_TRIGGERING_EVENT_TYPES = { 

P_EVENT_GCCS_ADDRESS_COLLECTED_EVENT, 

P_EVENT_GCCS_ADDRESS_ANALYSED_EVENT, 

P_EVENT_GCCS_CALLED_PARTY_BUSY, 

P_EVENT_GCCS_CALLED_PARTY_UNREACHABLE, 

P_EVENT_GCCS_NO_ANSWER_FROM_CALLED_PARTY, 

P_EVENT_GCCS_ROUTE_SELECT_FAILURE, 



P_DYNAMIC_EVENT_TYPES = { 

P_CALL_REPORT_ANSWER, 

P_CALL_REPORT_BUSY, 

P_CALL_REPORT_NO_ANSWER, 

P_CALL_REPORT_DISCONNECT, 

P_CALL_REPORT_ROUTING_FAILURE 



P_ADDRESS_PLAN = { 
P_ADDRESS_PLAN_E164 



P_UI_CALL_BASED 
TRUE 



P_UI_AT_ALL_STAGES 
FALSE 



P_MEDIA_TYPE 
P_AUDIO 
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6.6 



Generic Call Control Data Definitions 



The present document provides the GCC data definitions necessary to support the API specification. 

The present document is written using Hypertext Hnk, to aid navigation through the data structures. UnderHned text 
represents Hypertext Hnks. 

The general format of a Data Definition specification is described below. 

• Data Type 

This shows the name of the data type. 

• Description 

This describes the data type. 

• Tabular Specification 

This specifies the data types and values of the data type. 

• Example 

If relevant, an example is shown to illustrate the data type. 

6.6.1 Generic Gall Control Event Notification Data Definitions 
TpCallEventName 

Defines the names of event being notified. The following events are supported. The values may be combined by a 
logical 'OR' function when requesting the notifications. Additional events that can be requested / received during the 
call process are found in the TpCallReportType data-type. 



Name 


Value 


Description 


P_EVENT_NAME_UNDEF INED 





Undefined 


P_EVENT_GCCS_OFFHOOK_EVENT 


1 


GCCS - Offhook event 

This can be used for hot-line features. In case this event 
is set in the TpCallEventCriteria, only the originating 
address(es) may be specified in the criteria. 


P_EVENT_GCCS_ADDRESS_COLLECTED_EVENT 


2 


GCCS -Address information collected 
The network has collected the information from the A- 
party, but not yet analysed the information. The number 
can still be incomplete. Applications might set 
notifications for this event when part of the number 
analysis needs to be done in the application (see also 
the getlVloreDialledDigits method on the call class). 


P_EVENT_GCCS_ADDRESS_ANALYSED_EVENT 


4 


GCCS -Address information is analysed 

The dialled number is a valid and complete number in 

the network. 


P_EVENT_GCCS_CALLED_PARTY_BUSY 


8 


GCCS - Called party is busy 


P_EVENT_GCCS_CALLED_PARTY_UNREACHABLE 


16 


GCCS - Called party is unreachable (e.g. the called 
party has a mobile telephone that is currently switched 
off). 


P_EVENT_GCCS_NO_ANSWER_FROM_CALLED_PARTY 


32 


GCCS - No answer from called party 


P_EVENT_GCCS_ROUTE_SELECT_FAILURE 


64 


GCCS - Failure in routing the call 


P_EVENT_GCCS_ANSWER_FROM_CALL_PARTY 


128 


GCCS - Party answered call. 



TpCallNotificationType 

Defines the type of notification. Indicates whether it is related to the originating of the terminating user in the call. 
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Name 


Value 


Description 


P_ORIGINATING 


1 


Indicates that the notification is related to the originating user in the call. 


P_TERMINATING 


2 


Indicates that the notification is related to the terminating user in the call. 



TpCallEventCriteria 



Defines the Sequence of Data Element s that specify the criteria for a event notification. 

Of the addresses only the Plan and the AddrString are used for the purpose of matching the notifications against the 
criteria. 



Sequence Element 
Name 


Sequence Element 
Type 


Description 


DestinationAddress 


TpAddressRange 


Defines the destination address or address range for which the notification is 
requested. 


OriginatingAddress 


TpAddressRange 


Defines the origination address or a address range for which the notification is 

requested. 


CallEventName 


TpCallEventName 


Name of the event(s) 


CallNotificationType 


TpCallNotificationType 


Indicates whether it is related to the originating or the terminating user in the 

call. 


MonitorMode 


TpCallMonitorMode 


Defines the mode that the call is in following the notification. 

Monitor mode P_CALL_MONITOR_MODE_DO_NOT_MONITOR is not a 

legal value here. 



TpCallEventlnfo 

Defines the Sequence of Data Elements that specify the information returned to the appHcation in a Call event 
notification. 



Sequence Element Name 


Sequence Element Type 


DestinationAddress 


TpAddress 


OriginatingAddress 


TpAddress 


OriginalDestinationAddress 


TpAddress 


Redirect ingAddress 


TpAddress 


CallAppInfo 


TpCallAppInfoSet 


CallEventName 


TpCallEventName 


CallNotificationType 


TpCallNotificationType 


MonitorMode 


TpCallMonitorMode 



6.6.2 Generic Call Control Data Definitions 
ipCall 

Defines the address of an IpCall Interface. 

IpCallRef 

Defines a Reference to type IpCall. 

IpAppCall 

Defines the address of an IpAppCall Interface. 

IpAppCallRef 

Defines a Reference to type IpAppCall 
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IpAppCallRefRef 

Defines a Reference to type IpAppCallRef. 

TpCallldentifierRef 

Defines a Reference to type TpCallldentifier. 

TpCallldentifier 

Defines the Sequence of Data Elements that unambiguously specify the Generic Call object 



Sequence Element 
Name 


Sequence Element 
Type 


Sequence Element Description 


CallReference 


IpCallRef 


This element specifies the interface reference for the call object. 


CallSessionID 


TpSessionID 


This element specifies the call session ID of the call. 



IpAppCallControlManager 

Defines the address of an IpAppCallControlManager Interface. 

IpAppCallControlManagerRef 

Defines a Reference to type IpAppCallControlManager. 

IpCallControlManager 

Defines the address of an IpCallControlManager Interface. 

IpCallControlManagerRef 

Defines a Reference to type IpCallControlManager. 

TpCallAppInfo 

Defines the Tagged Choice of Data Elements that specify application-related call information. 





Tag Element Type 






TpCallAppInfoType 





Tag Element 
Value 


Choice Element 
Type 


Choice Element Name 


P_CALL_APP_ALERTING_MECHANISM 


TPCallAlertingMechanism 


CallAppAlertingMechanism 


P_CALL_APP_NETWORK_ACCESS_TYPE 


TpCallNetworkAccessType 


CallAppNetworkAccessType 


P_CALL_APP_TELE_SERVICE 


TpCallTeleService 


CallAppTeleService 


P_CALL_APP_BEARER_SERVICE 


TpCallBearerService 


CallAppBearer Service 


P_CALL_APP_P ART Y_CATE GORY 


TpCallPartyCategory 


CallAppPartyCategory 


P_CALL_APP_PRESENTATION_ADDRESS 


TpAddress 


CallAppP resent at ionAddress 


P_CALL_APP_GENERIC_INFO 


TpString 


CallAppGenericInfo 


P_CALL_APP_ADDITIONAL_ADDRESS 


TpAddress 


CallAppAdditionalAddress 



TpCallAppInfoType 

Defines the type of call application-related specific information. 
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Name 


Value 


Description 


P_CALL_APP_UNDEFINED 





Undefined 


P_CALL_APP_ALERTING_MECHANISM 


1 


The alerting mechanism or pattern to use 


P_CALL_APP_NETWORK_ACCESS_TYPE 


2 


The network access type (e.g. ISDN) 


P_CALL_APP_TELE_SERVICE 


3 


Indicates the tele-service (e.g. telephony) 


P_CALL_APP_BEARER_SERVICE 


4 


Indicates the bearer service (e.g. 64kbit/s unrestricted data). 


P_CALL_APP_P ART Y_CATE GORY 


5 


The category of the caUing party 


P_CALL_APP_PRESENTATION_ADDRESS 


6 


The address to be presented to other call parties 


P_CALL_APP_GENERIC_INFO 


7 


Carries unspecified service-service information 


P_CALL_APP_ADDITIONAL_ADDRESS 


8 


Indicates an additional address 



TpCallAppInfoSet 

Defines a Numbered Set of Data Elements of TpCallAppInfo. 



TpCallEndedReport 

Defines the Sequence of Data Elements that specify the reason for the call ending. 



Sequence Element 
Name 


Sequence Element 
Type 




CallLegSessionID 


TpSessionID 


The leg that initiated the release of the call. 
If the call release was not initiated by the leg, then this value is set to -1 . 


Cause 


TpCallReleaseCause 


The cause of the call ending. 



TpCallFault 

Defines the cause of the call fault detected. 



Name 


Value 


Description 


P_CALL_FAULT_UNDEF INED 





Undefined 


P_CALL_T IMEOUT_ON_RELEASE 


1 


This fault occurs when the final report has 

been sent to the appHcation, but the application 

did not explicitly release or deassign the call 

object, within a specified time. 

The timer value is operator specific. 


P_CALL_TIMEOUT_ON_INTERRUPT 


2 


This fault occurs when the appHcation did not 

instruct the gateway how to handle the call 

within a specified time, after the gateway 

reported an event that was requested by the 

appHcation in interrupt mode. 

The timer value is operator specific. 



TpCalllnfoReport 

Defines the Sequence of Data Element s that specify the call information requested. Information that was not 
requested is invalid. 
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Sequence Element 
Name 


Sequence Element 
Type 


Description 


CalllnfoType 


TpCalllnfoType 


The type of call report. 


Call InitiationSt art Time 


TpDateAndTime 


The time and date when the call, or follow-on call, was 
started as a result of a routeReq. 


CallConnectedToResourceTime 


TpDateAndTime 


The date and time when the call was connected to the 

resource. 

This data element is only valid when information on user 

interaction is reported. 


CallConnectedToDestinationTime 


TpDateAndTime 


The date and time when the call was connected to the 
destination (i.e. when the destination answered the call). 
If the destination did not answer, the time is set to an 
empty string. 

This data element is invalid when information on user 
interaction is reported. 


CallEndTime 


TpDateAndTime 


The date and time when the call or follow-on call or user 
interaction was terminated. 


Cause 


TpCallReleaseCause 


The cause of the termination. 



A calllnfoReport will be generated at the end of user interaction and at the end of the connection with the associated 
address. This means that either the destination related information is present or the resource related information, but not 
both. 



TpCallReleaseCause 

Defines the Sequence of Data Elements that specify the cause of the release of a call. 



L^_ Sequence Element 
■^ Name 


Sequence Element 
Type 


Value 


Tplnt32 


Location 


Tplnt32 


NOTE: The Value and Location are specified as in ITU-T Recommendation Q.850. I 



The following example was taken from Q.850 to aid understanding: 



Equivalent Call Report 


Cause Value Set by 
Application 


Cause Value from 
Network 


P_CALL_REPORT_BUSY 


17 


17 


P_CALL_REPORT_NO_ANSWER 


19 


18,19,21 


P_CALL_REPORT_DISCONNECT 


16 


16 


P_CALL_REPORT_REDIRECTED 


23 


23 


P_CALL_REPORT_SERVICE_CODE 


31 


NA 


P_CALL_REPORT_ROUTING_FAILURE 


3 


Any other value 



TpCallReport 

Defines the Sequence of Data Element s that specify the call report and call leg report specific information. 



Sequence Element 
Name 


Sequence Element 
Type 


MonitorMode 


TpCallMonitorMode 


CallEventTime 


TpDateAndTime 


CallReportType 


TpCallReport Type 


AdditionalReportlnfo 


TpCallAdditionalReportlnfo 



TpCallAdditionalReportlnfo 

Defines the Tagged Choice of Data Elements that specify additional call report information for certain types 
of reports. 
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Tag Element Type 






TpCallReportType 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_CALL_REPORT_UNDEFINED 


NULL 


Undefined 


P_CALL_REPORT_PROGRESS 


NULL 


Undefined 


P_CALL_REPORT_ALERTING 


NULL 


Undefined 


P_CALL_REPORT_ANSWER 


NULL 


Undefined 


P_CALL_REPORT_BUSY 


TpCallReleaseCause 


Busy 


P_CALL_REPORT_NO_ANSWER 


NULL 


Undefined 


P_CALL_REPORT_DISCONNECT 


TpCallReleaseCause 


CallDisconnect 


P_CALL_REPORT_REDIRECTED 


Tp Address 


Forward Address 


P_CALL_REPORT_SERVICE_CODE 


TpCallServiceCode 


ServiceCode 


P_CALL_REPORT_ROUTING_FAILURE 


TpCallReleaseCause 


RoutingFailure 



TpCallReportRequest 

Defines the Sequence of Data Elements that specify the criteria relating to call report requests. 



Sequence Element Name 


Sequence Element Type 


MonitorMode 


TpCallMonitorMode 


CallReportType 


TpCallReportType 


AdditionalReport Criteria 


TpCallAdditionalReportCriteria 



TpCallAdditionalReportCriteria 

Defines the Tagged Choice of Data Elements that specify specific criteria. 





Tag Element Type 






TpCallReportType 





Tag Element 
Value 


Choice Element 
Type 


Choice Element 
Name 


P_CALL_REPORT_UNDEFINED 


NULL 


Undefined 


P_CALL_REPORT_PROGRESS 


NULL 


Undefined 


P_CALL_REPORT_ALERTING 


NULL 


Undefined 


P_CALL_REPORT_ANSWER 


NULL 


Undefined 


P_CALL_REPORT_BUSY 


NULL 


Undefined 


P_CALL_REPORT_NO_ANSWER 


TpDuration 


NoAnswerDuration 


P_CALL_REPORT_DISCONNECT 


NULL 


Undefined 


P_CALL_REPORT_REDIRECTED 


NULL 


Undefined 


P_CALL_REPORT_SERVICE_CODE 


TpCallServiceCode 


ServiceCode 


P_CALL_REPORT_ROUTING_FAILURE 


NULL 


Undefined 



TpCallReportRequestSet 

Defines a Numbered Set of Data Elements of TpCallReportRequest. 

TpCallReportType 

Defines a specific call event report type. 
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Name 


Value 


Description 


P_CALL_REPORT_UNDEFINED 





Undefined. 


P_CALL_REPORT_PROGRESS 


1 


Call routing progress eventian indication from the network that progress has been made in 

routing the call to the requested call party. This message may be sent more than once, or 

may not be sent at all by the gateway with respect to routing a given call leg to a given 

address. 


P_CALL_REPORT_ALERT ING 


2 


Call is alerting at the call party. 


P_CALL_REPORT_ANSWER 


3 


Call answered at address. 


P_CALL_REPORT_BUSY 


4 


Called address refused call due to busy. 


P_CALL_REPORT_NO_ANSWER 


5 


No answer at called address. 


P_CALL_REPORT_DISCONNECT 


6 


The media stream of the called party has disconnected. This does not imply that the call has 
ended. When the call is ended, the callEnded method is called. This event can occur both 
when the called party hangs up, or when the application explicitly releases the leg using 

IpCallLeg::release() This cannot occur when the app explicitly releases the call leg and the 

call. 


P_CALL_REPORT_REDIRECTED 


7 


Call redirected to new address: an indication from the network that the call has been 
redirected to a new address. 


P_CALL_REPORT_SERVICE_CODE 


8 


Mid-call service code received. 


P_CALL_REPORT_ROUTING_FAILURE 


9 


Call routing failed - re-routing is possible. 


P_CALL_REPORT_QUEUED 


10 


The call is being held in a queue. This event may be sent more than once during the routing 

of a call. 



TpCallTreatment 

Defines the Sequence of Data Elements that specify the the treatment for calls that will be handled only by the 
network (for example, call which are not admitted by the call load control mechanism). 



Sequence Element 
Name 


Sequence Element 
Type 


ReleaseCause 


TpCallReleaseCause 


AdditionalTreatmentlnfo 


TpCallAdditionalTreatmentlnfo 



TpCallEventCriteriaResultSetRef 

Defines a refernce to TpCallEventCriteriaResultSet. 

TpCallEventCriteriaResultSet 

Defines a set of TpCallEventCriteriaResult. 

TpCallEventCriteriaResult 

Defines a sequence of data elements that specify a requested call event notification criteria with the associated 
assignmentlD. 



Sequence Element 
Name 


Sequence Element 
Type 


Sequence Element 
Description 


EventCriteria 


TpCallEvent Criteria 


The event criteria that were specified by the appHcation. 


AssignmentlD 


Tplnt32 


The associated assignmentlD. This can be used to disable the notification. 
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MultiParty Call Control Service 

The Multi-Party Call Control API of 3GPP Rel4 relies on the CAMEL Service Environment (CSE). It should be noted 
that a number of restrictions exist because CAMEL phase 3 supports only two-party calls and no leg based operations. 
Furthermore application initiated calls are not supported in CAMEL phase 3. The detailed description of the supported 
methods is given in the chapter 7.5. 

6.7 Sequence Diagrams 
6.7.1 Application initiated call setup 

The following sequence diagram shows an application creating a call between party A and party B. Here, a call is 
created first. Then party A's call leg is created before events are requested on it for answer and then routed to the call. 
On answer from Party A, an announcement is played indicating that the call is being set up to party B. While the 
announcement is being played, party B's call leg is created and then events are reqiested on it for answer. On answer 
from Party B the announcement is cancelled and party B is routed to the call. 



The service may as a variation be extended to include 3 parties (or more). After the two party call is established, the 
application can create a new leg and request to route it to a new destination address in order to establish a 3 party call. 

The event that causes this to happen could for example be the report of answer event from B -party or controlled by the 
A-party by entering a service code (mid-call event). 

The procedure for call setup to party C is exactly the same as for the set up of the connection to party B (sequence 13 to 
17 in the sequence diagram). 



: (Logical I I j ^1 AppPartyA : ^1 AppPartvB : ^1 j I I j ^1 j ^1 PartyA : ^1 PartyB : ^1 j I : lpUICair ~ 
View::lpAppLoaic) IpAppMultiPartyCall 1 1 (IpAppMultiPartyCallLeg) | | (IpAppMultiPartvCallLeg) | | IpAppUICall |lpMultiPartvCallControlManaaer | | IpMultiPartyCall || IpCallLeg || IpCallLeg || IpUIManaaer | 



-^ 



^ 






-^u 






^ 



I: eventReportReq{ ) 



^ 



^ 



-^ 



1 : This message is used to create an object implementing the IpAppMultiPartyCall interface. 
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2: This message requests the object implementing the IpMultiPartyCallControlManager interface to create an object 
implementing the IpMultiPartyCall interface. 

3: Assuming that the criteria for creating an object implementing the IpMultiPartyCall interface (e.g. load control 
values not exceeded) is met it is created. 

4: Once the object implementing the IpMultiPartyCall interface is created it is used to pass the reference of the object 
implementing the IpAppMultiPartyCall interface as the callback reference to the object implementing the 
IpMultiPartyCall interface. Note that the reference to the callback interface could already have been passed in the 
createCall. 

5: This message instructs the object implementing the IpMultiPartyCall interface to create a call leg for customer A. 

6: Assuming that the criteria for creating an object implementing the IpCallLeg interface is met, message 6 is used to 
create it. 

7: This message requests the call leg for customer A to inform the application when the call leg answers the call. 

8: The call is then routed to the originating call leg. 

9: Assuming the call is answered, the object implementing party A's IpCallLeg interface passes the result of the call 
being answered back to its callback object. This message is then forwarded via another message (not shown) to the 
object implementing the IpAppLogic interface. 

10: A UlCall object is created and associated with the just created call leg. 

1 1 : This message is used to inform party A that the call is being routed to party B. 

12: An indication that the dialogue with party A has commenced is returned via message 13 and eventually forwarded 
via another message (not shown) to the object implementing the IpAppLogic interface. 

13: This message instructs the object implementing the IpMultiPartyCall interface to create a call leg for customer B. 

14: Assuming that the criteria for creating a second object implementing the IpCallLeg interface is met, it is created. 

15: This message requests the call leg for customer B to inform the application when the call leg answers the call. 

16: The call is then routed to the call leg. 

17: Assuming the call is answered, the object implementing party B's IpCallLeg interface passes the result of the call 
being answered back to its callback object. This message is then forwarded via another message (not shown) to the 
object implementing the IpAppLogic interface. 

18: This message then instructs the object implementing the IpUICall interface to stop sending announcements to party 
A. 

19: The application deassigns the call. This will also deassign the associated user interaction. 

6.7.2 Call Barring 2 

The following sequence diagram shows a call barring service, initiated as a result of a prearranged event being received 
by the framework. Before the call is routed to the destination number, the calling party is asked for a PIN code. The 
code is rejected and the call is cleared. 
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: (Logical _: _: _: : IpMultiPartvCallControlManaqer _: _: : IpUICall 

View::lpAppLoaic) IpAppMultiPartvCallControlManaqer IpAppMultiPartvCall IpAppUICall IpMultiPartvCall IpUIManaqer 



-^ 



2: createNotification( ) 



4: 'forward event' 



^ 



'eportNotification( ) 



^ 



8: sendlnfo/>ndCollectReq( ) 



^ 



^ 



-^ 



10: 'forward event' 



(t 



13: 'forward event' 



sefWlnfoReq( ) 



3: sendlnfoAndCollectRes( 



12:sendlnfoRes( ) 



^ 



^ 



1 : This message is used by the application to create an object implementing the IpAppMultiPartyCallControlManager 
interface. 

2: This message is sent by the application to enable notifications on new call events. As this sequence diagram depicts 
a call barring service, it is likely that all new call events destined for a particular address or address range prompted for 
a password before the call is allowed to progress. When a new call, that matches the event criteria, arrives a message 
(not shown) is directed to the object implementing the IpMultiPartyCallControlManager. Assuming that the criteria for 
creating an object implementing the IpMultiPartyCall interface (e.g. load control values not exceeded) is met, other 
messages (not shown) are used to create the call and associated call leg object. 

3: This message is used to pass the new call event to the object implementing the 
IpAppMultiPartyCallControlManager interface. 

4: This message is used to forward message 3 to the IpAppLogic. 

5: This message is used by the application to create an object implementing the IpAppMultiPartyCall interface. The 
reference to this object is passed back to the object implementing the IpMultiPartyCallControlManager using the return 
parameter of the callEventNotify. 

6: The application requests an list of all the legs currently in the call. 

7: This message is used to create a UlCall object that is associated with the incoming leg of the call. 

8: The call barring service dialogue is invoked. 

9: The result of the dialogue, which in this case is the PIN code, is returned to its callback object. 

10: This message is used to forward the previous message to the IpAppLogic 

1 1 : Assuming an incorrect PIN is entered, the calling party is informed using additional dialogue of the reason why the 
call cannot be completed. 
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12: This message passes the indication that the additional dialogue has been sent. 
13: This message is used to forward the previous message to the IpAppLogic. 
14: No more UI is required, so the UlCall object is released. 
15: This message is used by the application to clear the call. 

6.7.3 Call forwarding on Busy Service 

The following sequence diagram shows an application establishing a call forwarding on busy. 

When a call is made from A to B but the B -party is detected to be busy, then the application is informed of this and sets 
up a connection towards a C party. The C party can for instance be a voicemail system. 



AppLogic App Leg C : App Leg A : App Call : App COM : COM : Call : Leg A : Leg B : 

IpAppCallLeg IpAppCallLeg IpAppMultiPartyCall IpAppMultiPartyCallControlManage IpMultiPartyCallControlManage IpMultiPartyCall IpCallLeg IpCallLeg 



2: createNotification( ) 



16:createCallLeg( ) 



23: continueProcessing( 



I : reportNotification( 



3: eventReportReq( 



20: routeReq( ) 



27: eventReportRes( 



-m- 



— >i 

: "state transition to 



10: "state^ansition to 



-^au- 



18: "state transition to 



21 : "state transition to 



2^: "inform Call 



2|t: "inform Call 



25: "continue pall 



1 : This message is used by the application to create an object implementing the IpAppMultiPartyCallControlManager 
interface. 

2: This message is sent by the application to enable notifications on new call events. 

3: 

4: When a new call, that matches the event criteria, arrives a message ("busy") is directed to the object implementing 
the IpMultiPartyCallControlManager. Assuming that the criteria for creating an object implementing the 
IpMultiPartyCall interface is met, other messages are used to create the call and associated call leg objects. 

5: 

6: A new MultiPartyCall object is created to handle this particular call. 

7: A new CallLeg object corresponding to Party A is created. 
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8: The new Call Leg instance transits to state Initiating. 

9: 

10: 

1 1 : This message is used to pass the new call event to the object implementing the 
IpAppMultiPartyCallControlManager interface. Applied monitor mode is "interrupt" 

12: This message is used to forward the message to the IpAppLogic. 

13: This message is used by the application to create an object implementing the IpAppMultiPartyCall interface. The 
reference to this object is passed back to the object implementing the IpMultiPartyCallControlManager using the return 
parameter of the reportNotification. 

14: A new AppCallLeg is created to receive callbacks for the Leg corresponding to party A. 

15: A new AppCallLegC is created to receive callbacks for another leg. 

16: This message is used to create a new call leg object. The object is created in the idle state and not yet routed in the 
network. 

17: 

18: 

19: The application requests to be notified (monitor mode "INTERRUPT") when party C answers the call. 

20: The application requests to route the terminating leg to reach the associated party C. 

The application may request if so desired a call redirection by including the original destination address (field 
P_CALL_APP_ORIGINAL_DESTINATION_ADDRESS of TpCallAppInfo) in the request to route the call leg to the 
remote party C. 

21: 

22: 

23: The application requests to resume call processing for the terminating call leg to party B to terminate the leg. 
Alternative the application could request to deassign the leg to party B for example if it is not interested in possible 
requested call leg information (getlnfoRes, superviseRes). 

When the terminating call leg is destroyed, the AppLegB is notified and the event is forwarded to the application logic 
(not shown). 

24: 

25: The application requests to resume call processing for the originating call leg. 

As a result call processing is resumed in the network that will try to reach the associated party B. 

26: When the party C answers the call, the termination call leg is notified. 

27: Assuming the call is answered, the object implementing party C's IpCallLeg interface passes the result of the call 
being answered back to its callback object. 

28: This answer message is then forwarded to the object implementing the IpAppLogic interface. 



6.7.4 Call Information Collect Service 

The following sequence diagram shows an application monitoring a call between party A and a party B in order to 
collect call information at the end of the call for e.g. charging and/or statistic information collection purposes. The 
service may apply to ordinary two-party calls, but could also include a number translation of the dialed number and 
special charging (e.g. a premium rate service) . 
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Additional call leg related information is requested with the getlnfoReq and superviseReq methods. 

The answer and call release events are in this service example requested to be reported in notify mode and 

additional call leg related information is requested with the getlnfoReq and superviseReq methods in order to illustrate 
the information that can be collected and sent to the application at the end of the call. 

Furthermore is shows the order in which information is sent to the application: network release event followed by 
possible requested call leg information, then the destroy of the call leg object (callLegEnded) and finally the destroy of 
the call object (callEnded). 
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AppLogic App Leg B : App Leg A : App Call : App COM : CCM : Call : Leg A : Leg B : SCS 

IpAppCallLeg IpAppCallLeg IpAppMultiPartyCal IpAppMultiPartyCallControlManage IpMultiPartyCallControlManage IpMultiPartyCall IpCallLeg IpCallLeg 



(f- 



ir 



2: createNotification( 



-^ 



(t 



^ 



9: reportNotification( 



17: oventReportReq( 



24: eventRep(irtReq( 



25: getlnfoF:eq( ) 



26: continuePrccessing( 



-^ 



30: eventReportRes( 



34: eventReportRes( 



36: getlnfoRes( ) 
38: callLegEnded( 



43: eventReportRes( 



47: superviseRes( 



trigger event: Analysed 



^^w^ 



-^- 



23: "inforni Call 



27: "inform Call 



40: "inform Call 



51: "inform Call 



transition to 



16: "stae transition to 



22: "state transition to 



32: "Disconnect from A- 



33: "state transition to 



42: "state tiansition to 



Disconnect from B 



1 : This message is used by the application to create an object implementing the IpAppMultiPartyCallControlManager 
interface. 

2: This message is sent by the application to enable notifications on new call events. 

3: 

4: When a new call, that matches the event criteria, arrives a message ("analysed information") is directed to the object 
implementing the IpMultiPartyCallControlManager. Assuming that the criteria for creating an object implementing the 
IpMultiPartyCall interface is met, other messages are used to create the call and associated call leg object 
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5: 

6: A new MultiPartyCall object is created to handle this particular call. 

7: A new CallLeg object corresponding to Party A is created. 

8: The new Call Leg instance transits to state Active. 

9: This message is used to pass the new call event to the object implementing the 
IpAppMultiPartyCallControlManager interface. Applied monitor mode is "interrupt" 

10: This message is used to forward message 9 to the IpAppLogic. 

1 1: This message is used by the application to create an object implementing the IpAppMultiPartyCall interface. The 
reference to this object is passed back to the object implementing the IpMultiPartyCallControlManager using the return 
parameter of the reportNotification. 

12: A new AppCallLeg is created to receive callbacks for the Leg corresponding to party A. 

13: A new AppCallLeg is created to receive callbacks for another leg. 

14: This message is used to create a new call leg object. The object is created in the idle state and not yet routed in the 
network. 

15: A new CallLeg corresponding to party B is created. 

16: A transition to state Idle is made after the Call leg has been created. 

17: The application requests to be notified (monitor mode "NOTIFY") when party B answers the call and when the leg 
to B -party is released. 

18: The application requests to supervise the call leg to party B. 

19: The application requests information associated with the call leg to party b for example to calculate charging. 

20: The application requests a specific charge plan to be set for the call leg to party B. 

21: The application requests to route the terminating leg to reach the associated party B. 

22: The Call Leg instance transits to state Active. 

23: 

24: The application requests to be notified (monitor mode "Notify") when the leg to A-party is released. 

25: The application requests information associated with the call leg to party A for example to calculate charging. 

26: The application requests to resume call processing for the originating call leg. 

As a result call processing is resumed in the network that will try to reach the associated party B. 

27: 

28: 

29: When the B -party answers the call, the termination call leg is notified. 

30: Assuming the call is answered, the object implementing party B's IpCallLeg interface passes the result of the call 
being answered back to its callback object (monitor mode "NOTIFY"). 

31: This answer message is then forwarded. 

32: When the A-party releases the call, the originating call leg is notified (monitor mode "NOTIFY") and makes a 
transition to "releasing state". 

33: 

34: The application IpAppLegA is notified, as the release event has been requested to be reported in Notify mode. 
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35: The event is forwarded to the appHcation logic 

36: The call leg information is reported. 

37: The event is forwarded to the application logic 

38: The origination call leg is destroyed, the AppLegA is notified. 

39: The event is forwarded to the application logic 

40: 

41 : When the B-party releases the call or the call is released as a result of the release request from party A, i.e. a 
"originating release" indication, the terminating call leg is notified and makes a transition to "releasing state". 

42: 

43: If a network release event is received being a "terminating release" indication from called party B, the application 
IpAppLegB is notified, as the release event from party B has been requested to be reported in NOTIFY mode. 

Note: No report is sent if the release is caused by propagation of network release event being a "originating release" 
indication coming from calling party A. 

44: The event is forwarded to the application logic. 

45: The call leg information is reported. 

46: The event is forwarded to the application logic. 

47: The supervised call leg information is reported. 

48: The event is forwarded to the application logic. 

49: The terminating call leg is destroyed, the AppLegB is notified. 

50: The event is forwarded to the application logic. 

51: 

52: Assuming the IpCall object has been informed that the legs have been destroyed, the the IpAppMultiPartyCall is 
notified that the call is ended . 

53: The event is forwarded to the application logic. 



6.7.5 Complex Card Service 



The following sequence diagram shows an advanced card service, initiated as a result of a prearranged event being 
received by the framework. Before the call is made, the calling party is asked for an ID and PIN code. If the ID and PIN 
code are accepted, the calling party is prompted to enter the address of the destination party. A trigger of '#5' is then set 
on the controlling leg (the calling party's leg) such that if the calling party enters a '#5' an event will be sent to the 
application. The call is then routed to the destination party. Sometime during the call the calling party enters '#5' which 
causes the called leg to be released. The calling party is now prompted to enter the address of a new destination party, to 
which it is then routed. 
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laiitoMultiPartvcill I 



8: sendlnfo4ndCollectReq{ 






25: sencllnfoAndColfectRes( : 



27: createAndRouteCal 






1 : This message is used by the application to create an object implementing the IpAppMultiPartyCallControlManager 
interface. 

2: This message is sent by the application to enable notifications on new call events. As this sequence diagram depicts 
a call barring service, it is likely that all new call events destined for a particular address or address range result in the 
caller being prompted for a password before the call is allowed to progress. When a new call, that matches the event 
criteria set in message 2, arrives a message (not shown) is directed to the object implementing the 
IpMultiPartyCallControlManager. Assuming that the criteria for creating an object implementing the IpMultiPartyCall 
interface (e.g. load control values not exceeded) is met, other messages (not shown) are used to create the call and 
associated call leg object. 

3: This message is used to pass the new call event to the object implementing the 
IpAppMultiPartyCallControlManager interface. 
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4: This message is used to forward message 3 to the IpAppLogic. 

5: This message is used by the application to create an object implementing the IpAppMultiPartyCall interface. The 
reference to this object is passed back to the object implementing the IpMultiPartyCallControlManager using the return 
parameter of message 3. 

6: This message retuns the call legs currently in the call. In principle a reference to the call leg of the calling party is 
already obtained by the application when it was notified of the new call event. 

7: This message is used to associate a user interaction object with the calling party. 

8: The initial card service dialogue is invoked using this message. 

9: The result of the dialogue, which in this case is the ID and PIN code, is returned to its callback object using this 
message and eventually forwarded via another message (not shown) to the IpAppLogic. 

10: Assuming the correct ID and PIN are entered, the final dialogue is invoked. 

1 1 : The result of the dialogue, which in this case is the destination address, is returned and eventually forwarded via 
another message (not shown) to the IpAppLogic. 

12: This message is used to forward the address of the callback object. 

13: The trigger for follow-on calls is set (on service code). 

14: A new AppCallLeg is created to receive callbacks for another leg. Alternatively, the already existing AppCallLeg 
object could be passed in the subsequent createCallLeg(). In that case the application has to use the sessionlDs of the 
legs to distinguish between callbacks destined for the A-leg and callbacks destined for the B-leg. 

15: This message is used to create a new call leg object. The object is created in the idle state and not yet routed in the 
network. 

16: The application requests to be notified when the leg is answered. 

17: The application routes the leg. As a result the network will try to reach the associated party. 

18: When the B -party answers the call, the application is notified. 

19: The event is forwarded to the application logic. 

20: Legs that are created and routed explicitly are by default in state detached. This means that the media is not 
connected to the other parties in the call. In order to allow inband communication between the new party and the other 
parties in the call the media have to be explicitly attached. 

21: At some time during the call the calling party enters '#5'. This causes this message to be sent to the object 
implementing the Ip AppCallLeg interface, which forwards this event as a message (not shown) to the IpAppLogic. 

22: The event is forwarded to the application. 

23: This message releases the called party. 

24: Another user interaction dialogue is invoked. 

25: The result of the dialogue, which in this case is the new destination address is returned and eventually forwarded via 
another message (not shown) to the IpAppLogic. 

26: A new AppCallLeg is created to receive callbacks for another leg. 

27: The call is then forward routed to the new destination party. 

28: As a result a new Callleg object is created. 

29: This message passes the result of the call being answered to its callback object and is eventually forwarded via 
another message (not shown) to the IpAppLogic. 

30: When the A-party terminates the application is informed. 
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31: The event is forwarded to the application logic. 

32: Since the release of the A-party will in this case terminate the entire call, the application is also notified with this 
message. 

33: The event is forwarded to the application logic. 

34: Since the user interaction object were not released at the moment that the call terminated, the application receives 
this message to indicate that the UI resources are released in the gateway and no further communication is possible. 

35: The event is forwarded to the application logic. 

36: The application deassigns the call object. 



6.7.6 Hotline Service 

The following sequence diagram shows an application establishing a call between party A and pre-arranged party B 
defined to constitute a hot-line address. The address of the destination party is provided by the application as the calling 
party makes a call attempt (goes off-hook) and do not dial any number within a predefined time. In this case a pre- 
defined number (hot-line number) is provided by the application. The call is then routed to the pre-defined destination 
party. 

The call release is monitored to enable the sending of information to the application at call release, e.g. for charging 
purposes. 

NOTE: This service could be extended as follows: 

Sometime during the call the calling party enters '#5' which causes the called leg to be released. The calling party is now 
prompted to enter the address of a new destination party, to which it is then routed. 
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TF- 



32: "forward event" 



AppLogic App Leg B : App Leg A : App Call : App CCM : CCM : Call : Leg A : Leg B : SCS 

IpAppCallLeg IpAppCallLeg IpAppMultiPartyCall IpAppMultiPartyCallControlManager IpMultiPartyCallControlManager IpMultiPartyCall IpCallLeg IpCallLeg 



40: "forward evnnt" 



2:createNotification( ) 



10: "forward event" 



^ 



application interested" 



9: reportNotification( ) 



14:createCallLeg( ) 



eventReportReq( ) 



21 : eventReportReq( ) 



29: eventReportRes( ) 



31:callLegEnded( ) 



36: callLegEnded( ) 



'trigger event: Originating Call Attempt Autho 



"state transition to Initiating" 



23: "inform Call obje:t" 



38: "inform Call obje 



6: "stcte transition to Idle' 



24: "continue call processing" 



26: "Stat 5 transition to Acti' 



tstransition to Active' 



25: event "aWress_analysed" 



'Disconnect from 

< 

:ransition to Relea 



35: "state :ransition to Releasing" 



1 : This message is used by the application to create an object implementing the IpAppMultiPartyCallControlManager 
interface. 

2: This message is sent by the application to enable notifications on new call events. 

3: 

4: When a new call, that matches the event criteria, arrives a message ("analysed information") is directed to the object 
implementing the IpMultiPartyCallControlManager. Assuming that the criteria for creating an object implementing the 
IpMultiPartyCall interface is met, other messages are used to create the call and associated call leg object 

5: 

6: A new MultiPartyCall object is created to handle this particular call. 

7: A new CallLeg object corresponding to Party A is created. 
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8: The new Call Leg instance transits to state Initiating. 

9: This message is used to pass the new call event to the object implementing the 
IpAppMultiPartyCallControlManager interface. Applied monitor mode is "interrupt" 

10: This message is used to forward message 9 to the IpAppLogic. 

1 1: This message is used by the application to create an object implementing the IpAppMultiPartyCall interface. The 
reference to this object is passed back to the object implementing the IpMultiPartyCallControlManager using the return 
parameter of the reportNotification. 

12: A new AppCallLeg is created to receive callbacks for the Leg corresponding to party A. 

13: A new AppCallLeg is created to receive callbacks for another leg. 

14: This message is used to create a new call leg object. The object is created in the idle state and not yet routed in the 
network. 

15: A new CallLeg corresponding to party B is created. 

16: A transition to state Idle is made after the Call leg has been created. 

17: The application requests to be notified (monitor mode "NOTIFY") when the leg to party B is released. 

18: The application requests to route the terminating leg to reach the associated party as specified by the application 
("hot-line number"). 

19: The Call Leg instance transits to state Active. 

20: 

21: The application requests to be notified (monitor mode "Notify") when the leg to A-party is released. 

22: The application requests to resume call processing for the originating call leg. 

As a result call processing is resumed in the network that will try to reach the associated party as specified by the 
application (E.164 number provided by application). 

23: 

24: 

25: The originating call leg is notified that the number (provided by application) has been analysed by the network and 
the originating call leg STD makes a transition to "active" state. The application is not notified as it has not requested 
this event to be reported. 

26: 

27: When the B -party releases the call, the terminating call leg is notified (monitor mode "NOTIFY") and makes a 
transition to "Releasing state". 

28: 

29: The application is notified, as the release event has been requested to be reported in Notify mode. 

30: The event is forwarded to the application logic. 

3 1 : The terminating call leg is destroyed, the AppLegB is notified. 

32: This answer message is then forwarded. 

33: 

34: When the call release ("terminating release" indication) is propagated in the network toward the party A, the 
originating call leg is notified and makes a transition to "releasing state". This release event (being propagated from 
party B) is not reported to the application. 

35: 
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36: When the originating call leg is destroyed, the AppLegA is notified. 

37: The event is forwarded to the application logic 

38: 

39: When all legs have been destroyed, the IpAppMultiPartyCall is notified that the call is ended. 

40: The event is forwarded to the application logic. 



6.8 Class Diagrams 



The multiparty call control service consists of two packages, one for the interfaces on the application side and one for 
interfaces on the service side. 

The class diagrams in the following figures show the interfaces that make up the multi party call control application 
package and the multi party call control service package. This class diagram shows the interfaces of the multi-party call 
control application package and their relations to the interfaces of the multi-party call control service package. 



«lnterface» 
Ip Interface 
(from csapi) 



«lnterface» 

IpAppMultiPartyCallControlMa 

nager 



(from mpccs) 



%eportNotification() 

^allAbortedO 
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■%allOverloadCeased() 



«lnterface» 

IpMultiPartyCallControlManager 

(from mpccs) 
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■^reateNotificationO 
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%etCallLoadControl() 
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«lnterface» 

IpAppMultiPartyCall 

(from mpccs) 
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IpMultiPartyCall 
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Figure: Application Interfaces 
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This class diagram shows the interfaces of the multi-party call control service package. 



«lnterface» 

IpService 
(from csapi) 

*feetCallback() 
^etCallbackWithSessionlDJ) 



«lnterface» 

lpMultiPartyCallContrc|l 

Manager 



t 
t 



(from mpccs) 
;reateCall() 
;reateNotification() 
estroyNotificationO 
;hangeNotification() 
etNotificationO 
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1 



0..n 
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, *treateAndRouteCallLegReq[(t 

J|-elease() 

•deassignCallO 

•getlnfoReqO 

•feetChargePlanO 
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%uperviseReq() 



«lnterface» 

IpCallLeg 
(from mpccs) 



■■outeReqO 

*feventReportReq() 

%elease() 
n 'SetlnfoReqO 

■•SetCallO 

Attach MediaO 

*detachMedia() 

'SetLastRedirectedAddressj) 

*tontinueProcessing() 

■•feetChargePlanO 

■■feetAdviceOfChargeO 
r %uperviseReq() 
B^@3ssign() 



Figure: Service Interfaces 



6.9 MultiParty Call Control Service Interface Classes 

The Multi-party Call Control service enhances the functionality of the Generic Call Control Service with leg 
management. It also allows for multi-party calls to be established, i.e., up to a service specific number of legs can be 
connected simultaneously to the same call. 

The Multi-party Call Control Service is represented by the IpMultiPartyCallControlManager, IpMultiPartyCall, 
IpCallLeg interfaces that interface to services provided by the network. Some methods are asynchronous, in that they 
do not lock a thread into waiting whilst a transaction performs. In this way, the client machine can handle many more 
calls, than one that uses synchronous message calls. To handle responses and reports, the developer must implement 
IpAppMultiPartyCallControlManager, IpAppMultiPartyCall and IpAppCallLeg to provide the callback mechanism. 



6.9.1 Interface Glass IpMultiPartyCallControlManager 

Inherits from: IpService 

This interface is the 'service manager' interface for the Multi-party Call Control Service. The multi-party call control 
manager interface provides the management functions to the multi-party call control service. The application 
programmer can use this interface to provide overload control functionality, create call objects and to enable or disable 
call-related event notifications. The action table associated with the STD shows in what state the 
IpMultiPartyCallControlManager must be if a method can successfully complete. In other words, if the 
IpMultiPartyCallControlManager is in another state the method will throw an exception immediately. 



«lnterface» 
IpMultiPartyCallControlManager 
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createCall (appCall : in IpAppMultiPartyCallRef) : TpMultiPartyCallldentifier 

createNotification (appCallControlManager : in IpAppMultiPartyCallControlManagerRef, notificationRequest 
: in TpCallNotificationRequest) : TpAssignmentID 

destroyNotification (assignmentID : in TpAssignmentID) : void 

changeNotification (assignmentID : in TpAssignmentID, notificationRequest : in TpCallNotificationRequest) : 
void 

getNotification () : TpNotificationRequestedSet 

setCallLoadControl (duration : in TpDuration, mechanism : in TpCallLoadControlMechanism, treatment : in 
TpCallTreatment, addressRange : in TpAddressRange) : TpAssignmentID 



Method 
createCall () 

This method is used to create a new call object. An IpAppMultiPartyCallControlManager should already have been 
passed to the IpMultiPartyCallControlManager, 

otherwise the call control will not be able to report a callAborted() to the application (the application should invoke 
setCallbackO if it wishes to ensure this). 

Returns callReference: Specifies the interface reference and sessionID of the call created. 

Parameters 

appCall : in IpAppMultiPartyCallRef 

Specifies the application interface for callbacks from the call created. 

Returns 
TpMultiPartyCallldentifier 

Raises 

TpCommonExceptions , P_INVALID_INTERFACE_TYPE 



Method 
createNotification ( ) 

This method is used to enable call notifications so that events can be sent to the application. This is the first step an 
application has to do to get initial notifications of calls happening in the network. When such an event happens, the 
application will be informed by reportNotification(). In case the application is interested in other events during the 
context of a particular call session it has to use the create AndRouteCallLegReqO method on the call object or the 
eventReportReqO method on the call leg object. The application will get access to the call object when it receives thye 
reportNotification(). (Note that createNotification() is not applicable if the call is setup by the application). 

The createNotification method is purely intended for applications to indicate their interest to be notified when certain 
call events take place. It is possible to subscribe to a certain event for a whole range of addresses, e.g. the application 
can indicate it wishes to be informed when a call is made to any number starting with 800. 

If some application already requested notifications with criteria that overlap the specified criteria, the request is refused 
with P_INVALID_CRITERIA. The criteria are said to overlap if both originating and terminating ranges overlap and 
the same number plan is used and the same NotificationCallType is used. 
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If a notification is requested by an application with monitor mode set to notify, then there is no need to check the rest of 
the criteria for overlapping with any existing request as the notify mode does not allow control on a call to be passed 
over. Only one application can place an interrupt request if the criteria overlaps. 

If the same application requests two notifications with exactly the same criteria but different callback references, the 
second callback will be treated as an additional callback. Both notifications will share the same assignmentlD. The 
gateway will always use the most recent callback. In case this most recent callback fails the second most recent is used. 
In case the enableCallNotification contains no callback, at the moment the application needs to be informed the gateway 
will use as 

callback the callback that has been registered by setCallback(). 

Returns assignmentlD: Specifies the ID assigned by the generic call control manager interface for this newly-enabled 
event notification. 

Parameters 

appCallControlManager : in IpAppMultiPartyCallControlManagerRef 

If this parameter is set (i.e. not NULL) it specifies a reference to the application interface, which is used for callbacks. If 
set to NULL, the application interface defaults to the interface specified via the setCallback() method. 

notificationRequest : in TpCallNotif icationRequest 

Specifies the event specific criteria used by the application to define the event required. Only events that meet these 
criteria are reported. Examples of events are "incoming call attempt reported by network", "answer", "no answer", 
"busy". Individual addresses or address ranges may be specified for destination and/or origination. 

Returns 

TpAs s ignment ID 

Raises 

TpCommonExceptions, P_INVALID_CRITERIA, P_INVALID_INTERFACE_TYPE, 
P INVALID EVENT TYPE 



Method 
destroyNotif ication ( ) 

This method is used by the application to disable call notifications. 

Parameters 

assignmentlD : in TpAss ignment ID 

Specifies the assignment ID given by the generic call control manager interface when the previous enableNotification() 
was called. If the assignment ID does not correspond to one of the valid assignment IDs, the framework will return the 
error code P_INVALID_ASSIGNMENTID. If two callbacks have been registered under this assignment ID both of 
them will be disabled. 

Raises 

TpCommonExceptions , P_INVALID_ASSIGNMENT_ID 



Method 
changeNotif ication ( ) 

This method is used by the application to change the event criteria introduced with createNotification. Any stored 
criteria associated with the specified assignementID will be replaced with the specified criteria. 
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Parameters 

assignment ID : in TpAssignmentID 

Specifies the ID assigned by the generic call control manager interface for the event notification. If two callbacks have 
been registered under this assigment ID both of them will be disabled. 

notificationRequest : in TpCallNotif icationRequest 

Specifies the new set of event specific criteria used by the application to define the event required. Only events that 
meet these criteria are reported. 

Raises 

TpCommonExceptions, P_INVALID_ASSIGNMENT_ID, P_INVALID_CRITERIA, 
P INVALID EVENT TYPE 



Method 
getNotif ication ( ) 

This method is used by the application to query the event criteria set with createNotification or changeNotification. 
Returns notificationsRequested: Specifies the nofications that have been requested by the application. 

Parameters 

No Parameters were identified for this method 

Returns 
TpNotificationRequestedSet 

Raises 
TpCommonExceptions 



Method 
setCallLoadControl () 

This method imposes or removes load control on calls made to a particular address range within the call control service. 
The address matching mechanism is similar as defined for TpCallEventCriteria. 

Returns assignmentID: Specifies the assignmentID assigned by the gateway to this request. This assignementID can be 
used to correlate the callOverlloadEncountered and callOverloadCeased methods with the request. 

Parameters 

duration : in TpDuration 

Specifies the duration for which the load control should be set. 

A duration of indicates that the load control should be removed. 

A duration of -1 indicates an infinite duration (i.e., until disabled by the application) 

A duration of -2 indicates the network default duration. 

mechanism : in TpCallLoadControlMechanism 

Specifies the load control mechanism to use (for example, admit one call per interval), and any necessary parameters, 
such as the call admission rate. The contents of this parameter are ignored if the load control duration is set to zero. 
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treatment : in TpCallTreatment 

Specifies the treatment of calls that are not admitted. The contents of this parameter are ignored if the load control 
duration is set to zero. 

addressRange : in TpAddressRange 

Specifies the address or address range to which the overload control should be applied or removed. 

Returns 

TpAs s ignment ID 

Raises 

TpCommonExceptions, P_INVALID_ADDRESS, P_UNSUPPORTED_ADDRESS_PLAN 

6.9.2 Interface Class IpAppMultiPartyCallControlManager 

Inherits from: Iplnterface 

The Multi-Party call control manager application interface provides the application call control management functions 
to the Multi-Party call control service. 




reportNotification (callReference : in TpMultiPartyCallldentifier, callLegReferenceSet : in 

TpCallLegldentifierSet, notificationlnfo : in TpCallNotificationlnfo, assignmentID : in TpAssignmentID) : 
TpAppMultiPartyCallBack 

callAborted (callReference : in TpSessionID) : void 

managerlnterrupted () : void 

managerResumed () : void 

callOverloadEncountered (assignmentID : in TpAssignmentID) : void 

callOverloadCeased (assignmentID : in TpAssignmentID) : void 



Method 
reportNotification ( ) 

This method notifies the application of the arrival of a call-related event. 

If this method is invoked with a monitor mode of P_MONITOR_MODE_INTERRUPTED, then the APL has control of 
the call. If the APL does nothing with the call (including its associated legs) within a specified time period (the duration 
of which forms a part of the service level agreement), then the call in the network shall be released and callEnded() 
shall be invoked, giving a release cause of P_TIMER_EXPIRY. 

Returns appCallBack: Specifies references to the application interface which implements the callback interface for the 
new call and/or new call leg. This parameter may be null if the notification is being given in NOTIFY mode. 
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Parameters 

callReference : in TpMultiPartyCallldentifier 

Specifies the reference to the call interface to which the notification relates. This parameter will be null if the 
notification is being given in NOTIFY mode. 

callLegReferenceSet : in TpCallLegldentifierSet 

Specifies the set of all call leg references. First in the set is the reference to the originating callLeg. It indicates the call 
leg related to the originating party. In case there is a destination call leg this will be the second leg in the set. from the 
notificationlnfo can be found on who's behalf the notification was sent. 

However, this parameter will be null if the notification is being given in NOTIFY mode. 

notificationlnfo : in TpCallNotificationlnfo 

Specifies data associated with this event (e.g. the originating or terminating leg which reports the notification ). 

assignment ID : in TpAssignmentID 

Specifies the assignment id which was returned by the createNotification() method. The application can use assignment 
id to associate events with event specific criteria and to act accordingly. 

Returns 
TpAppMultiPartyCallBack 



Method 
callAborted ( ) 

This method indicates to the application that the call object has aborted or terminated abnormally. No further 
communication will be possible between the call and application. 

Parameters 

callReference : in TpSessionID 

Specifies the sessionID of call that has aborted or terminated abnormally. 



Method 

managerlnterrupted ( ) 

This method indicates to the application that event notifications and method invocations have been temporary 
interrupted (for example, due to network resources unavailable). 

Note that more permanent failures are reported via the Framework (integrity management). 

Parameters 

No Parameters were identified for this method 



Method 

managerResumed ( ) 

This method indicates to the application that event notifications possibleand method invocations are enabled. 

Parameters 

No Parameters were identified for this method 
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Method 
callOverloadEncountered ( ) 

This method indicates that the network has detected overload and may have automatically imposed load control on calls 
requested to a particular address range or calls made to a particular destination within the call control service. 

Parameters 

assignment ID : in TpAssignmentID 

Specifies the assignmentID corresponding to the associated setCallLoadControl. This implies the addressrange for 
within which the overload has been encountered. 



Method 

callOverloadCeased ( ) 

This method indicates that the network has detected that the overload has ceased and has automatically removed any 
load controls on calls requested to a particular address range or calls made to a particular destination within the call 
control service. 

Parameters 

assignmentID : in TpAssignmentID 

Specifies the assignmentID corresponding to the associated setCallLoadControl. This implies the addressrange for 
within which the overload has been ceased 

6.9.3 Interface Class IpMultiPartyCall 

Inherits from: Ip Service 

The Multi-Party Call provides the possibility to control the call routing, to request information from the call, control the 
charging of the call, to release the call and to supervise the call. It also gives the possibility to manage call legs 
explicitly. An application may create more then one call leg. 



«lnterface» 
IpMultiPartyCall 



getCallLegs (callSessionID : in TpSessionID) : TpCallLegldentifierSet 

createCallLeg (callSessionID : in TpSessionID, appCallLeg : in IpAppCallLegRef) : TpCallLegldentifier 

createAndRouteCallLegReq (callSessionID : in TpSessionID, eventsRequested : in 

TpCallEventRequestSet, targetAddress : in TpAddress, originatingAddress : in TpAddress, applnfo : in 
TpCallApplnfoSet, appLeg Interface : in IpAppCallLegRef) : TpCallLegldentifier 

release (callSessionID : in TpSessionID, cause : in TpReleaseCause) : void 

deassignCall (callSessionID : in TpSessionID) : void 

getlnfoReq (callSessionID : in TpSessionID, calllnfoRequested : in TpCalllnfoType) : void 

setChargePlan (callSessionID : in TpSessionID, callChargePlan : in TpCallChargePlan) : void 

setAdviceOfCharge (callSessionID : in TpSessionID, aOCInfo : in TpAoClnfo, tariffSwitch : in TpDuration) : 
void 

superviseReq (callSessionID : in TpSessionID, time : in TpDuration, treatment : in 
TpCallSuperviseTreatment) : void 
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Method 
getCallLegs () 

This method requests the identification of the call leg objects associated with the call object. Returns the legs in the 
order of creation. 

Returns callLegList: Specifies the call legs associated with the call. The set contains both the sessionlDs and the 
interface references. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

Returns 
TpCallLegldentifierSet 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
createCallLeg ( ) 

This method requests the creation of a new call leg object. 

Returns callLeg: Specifies the interface and sessionID of the call leg created. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

appCallLeg : in IpAppCallLegRef 

Specifies the application interface for callbacks from the call leg created. 

Returns 
TpCallLegldentifier 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_INTERFACE_TYPE 



Method 
createAndRouteCallLegReq ( ) 

This asynchronous operation requests creation and routing of a new callLeg. In case the connection to the destination 
party is established successfully the CallLeg is attached to the call, i.e. no explicit attachMedia() operation is needed. 
Requested events will be reported on the Ip AppCallLeg interface. This interface the application must provide through 
the appLeglnterface parameter. 
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The extra address information such as originating Address is optional. If not present (i.e., the plan is set to 
P_ADDRESS_PLAN_NOT_PRESENT), the information provided in corresponding addresses from the route is used, 
otherwise the network or gateway provided numbers will be used. 

If the application wishes that the call leg should be represented in the network as being a redirection it should include a 
value for the field P_CALL_APP_ORIGINAL_DESTINATION_ADDRESS of TpCallAppInfo. 

If this method is invoked, and call reports have been requested, yet the IpAppCallLeg interface parameter is NULL, this 
method shall throw the P_NO_CALLB ACK_ADDRESS_SET exception. 

Returns callLegReference: Specifies the reference to the CallLeg interface that was created. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

eventsRequested : in TpCallEventRequestSet 

Specifies the event specific criteria used by the application to define the events required. Only events that meet these 
criteria are reported. Examples of events are "adress analysed", "answer", "release". 

targetAddress : in TpAddress 

Specifies the destination party to which the call should be routed. 

originatingAddress : in TpAddress 

Specifies the address of the originating (calling) party. 

applnfo : in TpCallAppInfoSet 

Specifies application-related information pertinent to the call (such as alerting method, tele-service type, service 
identities and interaction indicators). 

appLeglnterface : in IpAppCallLegRef 

Specifies a reference to the application interface that implements the callback interface for the new call leg. Requested 
events will be reported by the eventReportRes() operation on this interface. 

Returns 
TpCallLegldentifier 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_INTERFACE_TYPE, 
P_INVALID_ADDRESS , P_UNSUPPORTED_ADDRESS_PLAN, P_INVALID_NETWORK_STATE, 
P_INVALID_EVENT_TYPE , P_INVALID_CRITERIA 



Method 
release () 

This method requests the release of the call object and associated objects. The call will also be terminated in the 
network. If the application requested reports to be sent at the end of the call (e.g., by means of getlnfoReq) these reports 
will still be sent to the application. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 
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cause : in TpReleaseCause 

Specifies the cause of the release. 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_NETWORK_STATE 



Method 
deassignCall () 

This method requests that the relationship between the application and the call and associated objects be de-assigned. It 
leaves the call in progress, however, it purges the specified call object so that the application has no further control of 
call processing. If a call is de-assigned that has call information reports, call leg event reports or call Leg information 
reports requested, then these reports will be disabled and any related information discarded. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
getlnfoReqO 

This asynchronous method requests information associated with the call to be provided at the appropriate time (for 
example, to calculate charging). This method must be invoked before the call is routed to a target address. 

A report is received when the destination leg or party terminates or when the call ends. The call object will exist after 
the call is ended if information is required to be sent to the application at the end of the call. In case the originating party 
is still available the application can still initiate a follow-on call using routeReq. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

calllnfoRequested : in TpCalllnfoType 

Specifies the call information that is requested. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
setChargePlan ( ) 

Set an operator specific charge plan for the call. The charge plan must be set before the call is routed to a target address. 
Depending on the operator the method can also be used to change the charge plan for ongoing calls. 
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Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

callChargePlan : in TpCallChargePlan 

Specifies the charge plan to use. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
setAdviceOf Charge ( ) 

This method allows for advice of charge (AOC) information to be sent to terminals that are capable of receiving this 
information. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

aOCInfo : in TpAoCInfo 

Specifies two sets of Advice of Charge parameter. 

tariffSwitch : in TpDuration 

Specifies the tariff switch interval that signifies when the second set of AoC parameters becomes valid. 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_CURRENCY, 
P INVALID AMOUNT 



Method 
superviseReq ( ) 

The application calls this method to supervise a call. The application can set a granted connection time for this call. If 
an application calls this operation before it routes a call or a user interaction operation the time measurement will start 
as soon as the call is answered by the B -party or the user interaction system. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

time : in TpDuration 

Specifies the granted time in milliseconds for the connection. 

treatment : in TpCallSuperviseTreatment 

Specifies how the network should react after the granted connection time expired. 
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Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 

6.9.4 Interface Class IpAppMultiPartyCall 

Inherits from: Iplnterface 

The Multi-Party call application interface is implemented by the client application developer and is used to handle call 
request responses and state reports. 



«lnterface» 
IpAppMultiPartyCall 



getlnfoRes (callSessionID : in TpSessionID, calllnfoReport : in TpCalllnfoReport) : void 

getlnfoErr (callSessionID : in TpSessionID, errorlndication : in TpCallError) : void 

superviseRes (callSessionID : in TpSessionID, report : in TpCallSuperviseReport, usedTlme : in 
TpDuration) : void 

superviseErr (callSessionID : in TpSessionID, errorlndication : in TpCallError) : void 

callEnded (callSessionID : in TpSessionID, report : in TpCallEndedReport) : void 

createAndRouteCallLegErr (callSessionID : in TpSessionID, callLegReference : in TpCallLegldentifier, 
errorlndication : in TpCallError) : void 



Method 
getlnfoRes () 

This asynchronous method reports time information of the finished call or call attempt as well as release cause 
depending on which information has been requested by getlnfoReq. This information may be used e.g. for charging 
purposes. The call information will possibly be sent after reporting of all cases where the call or a leg of the call has 
been disconnected or a routing failure has been encountered. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

calllnfoReport : in TpCalllnfoReport 

Specifies the call information requested. 



Method 
getlnfoErr () 

This asynchronous method reports that the original request was erroneous, or resulted in an error condition. 



ETSI 



3GPP TS 29.198-4 version 4.1.0 Release 4 



88 



ETSI TS 129 198-4 V4.1.0 (2001-09) 



Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

errorlndication : in TpCallError 

Specifies the error which led to the original request failing 



Method 

superviseRes () 

This asynchronous method reports a call supervision event to the application when it has indicated it's interest in these 
kind of events. 

It is also called when the connection is terminated before the supervision event occurs. Furthermore, this method is 
invoked as a response to the request also when a tariff switch happens in the network during an active call. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call 

report : in TpCallSuperviseReport 

Specifies the situation which triggered the sending of the call supervision response. 

usedTime : in TpDuration 

Specifies the used time for the call supervision (in milliseconds). 



Method 
superviseErr ( ) 

This asynchronous method reports a call supervision error to the application. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

errorlndication : in TpCallError 

Specifies the error which led to the original request failing. 



Method 
callEndedO 

This method indicates to the application that the call has terminated in the network. 

Note that the event that caused the call to end might have been received separately if the application was monitoring for 
it. 
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Parameters 

callSessionID : in TpSessionID 

Specifies the call sessionlD. 

report : in TpCallEndedReport 

Specifies the reason the call is terminated. 



Method 
createAndRouteCallLegErr ( ) 

This asynchronous method indicates that the request to route the call to the destination party was unsuccessful - the call 
could not be routed to the destination party (for example, the network was unable to route the call, the parameters were 
incorrect, the request was refused, etc.). Note that the event cases that can be monitored and correspond to an 
unsuccessful setup of a connection (e.g. busy, no_answer) will be reported by eventReportRes() and not by this 
operation. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

callLegReference : in TpCallLegldentif ier 

Specifies the reference to the CallLeg interface that was created. 

errorlndication : in TpCallError 

Specifies the error which led to the original request failing. 



6.9.5 Interface Class IpCallLeg 



Inherits from: Ip Service 

The call leg interface represents the logical call leg associating a call with an address. The call leg tracks its own states 
and allows charging summaries to be accessed. The leg represents the signalling relationship between the call and an 
address. An application that uses the IpCallLeg interface to set up connections has good control, e.g. by defining leg 
specific event request and can obtain call leg specific report and events. 



«lnterface» 
IpCallLeg 



routeReq (callLegSessionID : in TpSessionID, targetAddess : in TpAddress, originatingAddress : in 

TpAddress, applnfo : in TpCallApplnfoSet, connectionProperties : in TpCallLegConnectionProperties) : 
void 

eventReportReq (callLegSessionID : in TpSessionID, eventsRequested : in TpCallEventRequestSet) : void 

release (callLegSessionID : in TpSessionID, cause : in TpReleaseCause) : void 

getlnfoReq (callLegSessionID : in TpSessionID, callLeglnfoRequested : in TpCallLeglnfoType) : void 

getCall (callLegSessionID : in TpSessionID) : TpMultiPartyCallldentifier 

attachMedia (callLegSessionID : in TpSessionID) : void 



ETSI 



3GPP TS 29.198-4 version 4.1.0 Release 4 90 ETSI TS 129 198-4 V4.1.0 (2001-09) 



detachMedia (callLegSessionID : in TpSessionID) : void 

getLastRedirectedAddress (callLegSessionID : in TpSessionID) : TpAddress 

continueProcessing (callLegSessionID : in TpSessionID) : void 

setChargePlan (callLegSessionID : in TpSessionID, callChargePlan : in TpCallChargePlan) : void 

setAdviceOfCharge (callLegSessionID : in TpSessionID, aOCInfo : in TpAoClnfo, tarrifSwitch : in 
TpDuration) : void 

superviseReq (callLegSessionID : in TpSessionID, time : in TpDuration, treatment : in 
TpCallSuperviseTreatment) : void 

deassign (callLegSessionID : in TpSessionID) : void 



Method 
routeReq ( ) 

This asynchronous method requests routing of the call leg to the remote party indicated by the target Address. 

In case the connection to the destination party is established successfully the CallLeg will be either detached or attached 
to the call based on the attach Mechanism values specified in the connectionProperties parameter. 

The extra address information such as originatingAddress is optional. If not present (i.e. the plan is set to 
P_ADDRESS_PLAN_NOT_PRESENT), the information provided in the corresponding addresses from the route is 
used, otherwise network or gateway provided addresses will be used. 

If the application wishes that the call leg should be represented in the network as being a redirection it should include a 
value for the field P_CALL_APP_ORIGINAL_DESTINATION_ADDRESS of TpCallAppInfo. 

This operation continues processing of the call leg. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 

targetAddess : in TpAddress 

Specifies the destination party to which the call leg should be routed 

originatingAddress : in TpAddress 

Specifies the address of the originating (calling) party. 

applnfo : in TpCallAppInfoSet 

Specifies application-related information pertinent to the call leg (such as alerting method, tele-service type, service 
identities and interaction indicators). 

connectionProperties : in TpCallLegConnectionProperties 

Specifies the properties of the connection. 
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Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_NETWORK_STATE, 
P_INVALID_ADDRESS , P_UNSUPPORTED_ADDRESS_PLAN 



Method 
eventReportReq ( ) 

This asynchronous method sets, clears or changes the criteria for the events that the call leg object will be set to 
observe. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 

eventsRequested : in TpCallEventRequestSet 

Specifies the event specific criteria used by the application to define the events required. Only events that meet these 
criteria are reported. Examples of events are "address analysed", "answer", "release". 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_EVENT_TYPE, 
P INVALID CRITERIA 



Method 
release () 

This method requests the release of the call leg. If successful, the associated address (party) will be released from the 
call, and the call leg deleted. Note that in some cases releasing the party may lead to release of the complete call in the 
network. The application will be informed of this with callEnded(). 

This operation continues processing of the call leg. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 

cause : in TpReleaseCause 

Specifies the cause of the release. 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_NETWORK_STATE 



Method 
getlnfoReqO 

This asynchronous method requests information associated with the call leg to be provided at the appropriate time (for 
example, to calculate charging). Note: in the call leg information must be accessible before the objects of concern are 
deleted. 
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Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 

callLeglnfoRequested : in TpCallLeglnfoType 

Specifies the call leg information that is requested. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 

Method 
getCallO 

This method requests the call associated with this call leg. 

Returns callReference: Specifies the interface and sessionID of the call associated with this call le^ 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 

Returns 
TpMultiPartyCallldentifier 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
attachMedia ( ) 

This method requests that the call leg be attached to its call object. This will allow transmission on all associated bearer 
connections or media streams to and from other parties in the call. The call leg must be in the connected state for this 
method to complete successfully. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the sessionID of the call leg to attach to the call. 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_NETWORK_STATE 



Method 
detachMedia ( ) 

This method will detach the call leg from its call, i.e., this will prevent transmission on any associated bearer 
connections or media streams to and from other parties in the call. The call leg must be in the connected state for this 
method to complete successfully. 
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Parameters 

callLegSessionID : in TpSessionID 

Specifies the sessionID of the call leg to detach from the call. 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_NETWORK_STATE 

Method 
getLastRedirectedAddress () 

Queries the last address the leg has been redirected to. 

Returns redirectedAddress: Specifies the last address where the call leg was redirected to. 

If this method is invoked on the Originating Call Leg, exception P_INVALID_STATE will be thrown. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call session ID of the call leg. 

Returns 
TpAddress 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
continueProcessing ( ) 

This operation continues processing of the call leg. Applications can invoke this operation after call leg processing was 
interrupted due to detection of a notification or event the application subscribed its interest in. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_NETWORK_STATE 



Method 
setChargePlan ( ) 

Set an operator specific charge plan for the cal leg. The charge plan must be set before the call leg is routed to a target 
address. Depending on the operator the method can also be used to change the charge plan for ongoing calls. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call party. 



ETSI 



3GPP TS 29.198-4 version 4.1.0 Release 4 



94 



ETSI TS 129 198-4 V4.1.0 (2001-09) 



callChargePlan : in TpCallChargePlan 

Specifies the charge plan to use. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
setAdviceOf Charge ( ) 

This method allows for advice of charge (AOC) information to be sent to terminals that are capable of receiving this 
information. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call party. 

aOCInfo : in TpAoCInfo 

Specifies two sets of Advice of Charge parameter. 

tarrifSwitch : in TpDuration 

Specifies the tariff switch interval that signifies when the second set of AoC parameters becomes valid. 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_CURRENCY, 
P INVALID AMOUNT 



Method 
superviseReq ( ) 

The application calls this method to supervise a call leg. The application can set a granted connection time for this call. 
If an application calls this function before it calls a routeReqO or a user interaction function the time measurement will 
start as soon as the call is answered by the B -party or the user interaction system. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call party. 

time : in TpDuration 

Specifies the granted time in milliseconds for the connection. 

treatment : in TpCallSuperviseTreatment 

Specifies how the network should react after the granted connection time expired. 
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Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



Method 
deassign () 

This method requests that the relationship between the appHcation and the call leg and associated objects be de- 
assigned. It leaves the call leg in progress, however, it purges the specified call leg object so that the application has no 
further control of call leg processing. If a call leg is de-assigned that has event reports or call leg information reports 
requested, then these reports will be disabled and any related information discarded. 

The application should not release or deassign the call leg when received a callLegEnded() or callEnded(). This 
operation continues processing of the call leg. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



6.9.6 Interface Class IpAppCallLeg 

Inherits from: Iplnterface 

The application call leg interface is implemented by the client application developer and is used to handle responses and 
errors associated with requests on the call leg in order to be able to receive leg specific information and events. 



«lnterface» 
IpAppCallLeg 



eventReportRes (callLegSessionID : in TpSessionID, eventlnfo : in TpCallEventlnfo) : void 

eventReportErr (callLegSessionID : in TpSessionID, errorlndication : in TpCallError) : void 

getlnfoRes (callLegSessionID : in TpSessionID, callLeglnfoReport : in TpCallLeglnfoReport) : void 

getlnfoErr (callLegSessionID : in TpSessionID, errorlndication : in TpCallError) : void 

routeErr (callLegSessionID : in TpSessionID, errorlndication : in TpCallError) : void 

superviseRes (callLegSessionID : in TpSessionID, report : in TpCallSuperviseReport, usedTime : in 
TpDuration) : void 

superviseErr (callLegSessionID : in TpSessionID, errorlndication : in TpCallError) : void 

callLegEnded (callLegSessionID : in TpSessionID, cause : in TpReleaseCause) : void 



Method 
eventReportRes () 
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This asynchronous method reports that an event has occurred that was requested to be reported (for example, a mid-call 
event, the party has requested to disconnect, etc.). 

Depending on the type of event received, outstanding requests for events are discarded. The exact details of these so- 
called disarming rules are captured in the data definition of the event type. 

If this method is invoked for a report with a monitor mode of P_MONITOR_MODE_INTERRUPTED, then the 
application has control of the call leg. If the application does nothing with the call leg within a specified time period 
(the duration which forms a part of the service level agreement), then the connection in the network shall be released 
and callLegEndedO shall be invoked, giving a release cause of P_TIMER_EXPIRY. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg on which the event was detected. 

event Info : in TpCallEventlnfo 

Specifies data associated with this event. 



Method 
eventReportErr ( ) 

This asynchronous method indicates that the request to manage call leg event reports was unsuccessful, and the reason 
(for example, the parameters were incorrect, the request was refused, etc.). 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 

errorlndication : in TpCallError 

Specifies the error which led to the original request failing. 



Method 

getlnfoRes () 

This asynchronous method reports all the necessary information requested by the application, for example to calculate 
charging. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg to which the information relates. 

callLeglnfoReport : in TpCallLeglnfoReport 

Specifies the call leg information requested. 



Method 
getlnfoErr () 

This asynchronous method reports that the original request was erroneous, or resulted in an error condition. 
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Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 

errorlndication : in TpCallError 

Specifies the error which led to the original request failing. 



Method 
routeErr ( ) 



Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 

errorlndication : in TpCallError 

Specifies the error which led to the original request failing 



Method 

superviseRes () 

This asynchronous method reports a call leg supervision event to the application when it has indicated its interest in 
these kind of events. 

It is also called when the connection to a party is terminated before the supervision event occurs. Furthermore, this 
method is invoked as a response to the request also when a tariff switch happens in the network during an active call. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg 

report : in TpCallSuperviseReport 

Specifies the situation which triggered the sending of the call leg supervision response. 

usedTime : in TpDuration 

Specifies the used time for the call leg supervision (in milliseconds). 



Method 
superviseErr ( ) 



Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 
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Method 
callLegEnded ( ) 

This method indicates to the application that the leg has terminated in the network. The application has received all 
requested results (e.g., getlnfoRes) related to the call leg. The call leg will be destroyed after returning from this 
method. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 

cause : in TpReleaseCause 

Specifies the reason the connection is terminated. 



6.10 MultiParty Call Control Service State Transition Diagrams 
6.10.1 State Transition Diagrams for IpMuitiPartyCaiiControlManager 
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Figure : Application view and the Multi-Party Call Control Manager 
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6.10.1.1 Active state 

In this state a relation between the AppHcation and the Service has been estabHshed. The state allows the application to 
indicate that it is interested in call related events. In case such an event occurs, the Manager will create a Call object 
with the appropriate number of Call Leg objects and inform the application. The application can also indicate it is no 
longer interested in certain call related events by calling destroyNotification(). 

6.10.1.2 Interrupted State 

When the Manager is in the Interrupted state it is temporarily unavailable for use. Events requested cannot be 
forwarded to the application and methods in the API cannot successfully be executed. A number of reasons can cause 
this: for instance the application receives more notifications from the network than defined in the Service Agreement. 
Another example is that the Service has detected it receives no notifications from the network due to e.g. a link failure. 

6.10.1.3 Overview of allowed methods 



Call Control Manager State 


Methods applicable 


Active 


createCall, 

createNotification, 

destroyNotification, 

changeNotification, 

getNotification, 

setCallLoadControl 


Interrupted 


getNotification 



6.10.2 State Transition Diagrams for IpMultiPartyCall 

The state transition diagram shows the application view on the MultiParty Call object. 

When an IpMultiPartyCall is created using createCall, or when an IpMultiPartyCall is given to the application for a 
notification with a monitor mode of P_MONITOR_MODE_INTERRUPT, an activity timer is started. The activity 
timer is stopped when the application invokes a method on the IpMultiPartyCall. The action upon expiry of this activity 
timer is to invoke callEnded() on the IpAppMultiPartyCall with a release cause of P_TIMER_EXPIRY. In the case 
when no IpAppMultiPartyCall is available on which to invoke callEnded(), callAborted() shall be invoked on the 
IpAppMultiPartyCallControlManager as this is an abnormal termination. 
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A timer mechanisem prevents that the object 
keeps occupying resources. In case the timer 
expires, callEnded() is invoked on the 
IpAppMultiPartyCall with a release cause of 
P_TIMER_EXPIRY. In the case when no 
IpAppMultiPartyCall is available on which to invoke 
callEndedO, callAborted() shall be invoked on the 
IpAppMultiPartyCallControlManager as this is an 
abnormal termination. 



K 



Figure : Application view on the MultiParty Call object 

6.10.2.1 IDLE State 

In this state the Call object has no Call Leg object associated to it. 

The application can request for charging related information reports, call supervision, set the charge plan and set Advice 
Of Charge indicators. When the first Call Leg object is requested to be created a state transition is made to the Active 
state. 

6.10.2.2 ACTIVE State 

In this state the Call object has one or more Call Leg objects associated to it. The application is allowed to create 
additional Call Leg objects. 

Furthermore, the application can request for call supervision. The Application can request charging related information 
reports, set the charge plan and set Advice Of Charge indicators in this state prior to call establishment. 

6.10.2.3 RELEASED State 

In this state the last Call leg object has released or the call itself was released. While the call is in this state, the 
requested call information will be collected and returned through getlnfoReqO and / or superviseReq(). As soon as all 
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information is returned, the application will be informed that the call has ended and Call object transition to the end 
state. 

6.1 0.2.4 Overview of allowed methods 



Methods applicable 


Call Control Call State 


Call Control Manager State 


getCallLegs, 


Idle, Active, Released 


- 


createCallLeg, 

create And RouteCal 1 Leg Req , setAdviceOf Charge , 

superviseReq, 


Idle, Active 


Active 


Release 


Active 


Active 


Deassign 


Idle, Active 


- 


GetlnfoReq 


Idle 


Active 


SetChargePlan 


Idle, Active 


Active 



6.10.3 State Transition Diagrams for IpCallLeg 

The IpCallLeg State Transition Diagram is divided in two State Transition Diagrams, one for the originating call leg 
and one for the terminating call leg. 

Call Leg State Model General Objectives: 

1) Events in backwards direction (upstream), coming from terminating leg, are not visible in originating leg model. 

2) Events in forwards direction (downstream), coming from originating leg, are not visible in terminating leg 
model. 

3) States are as seen from the application: if there is no change in the method an application is permitted to apply 
on the IpCallLeg object, then there is no state change. Therefore receipt of e.g. answer or alerting events on 
terminating leg do not change state. NOTE 2 

4) The application is to send a request to continue processing (using an appropriate method like 
continueProcessing) for each leg and event reported in monitor mode 'interrupt'. The call processing is resumed 
in the network when no leg in the call is left suspended. 

5) In case on a leg more than one network event (for example mid-call event 'service_code') is to be reported to the 
application at quasi the same time, then the events are to be reported one by one to the application in the order 
received from the network. When for a leg an event is reported in interrupt mode, a next pending event is not to 
be reported to the application until a request to resume call processing for the current reported event has been 
received on the leg. 

NOTEl : Call processing is suspended if for a leg a network event is met, which was requested to be monitored in 
theP_CALL_MONITOR_MODE_INTERRUPT. 

N0TE2: Even though there in the Originating Call Leg STD is no change in the methods the application is 
permitted to apply to the IpCallLeg object for the states Analysing and Active, separate states are 
maintained. The states may therefore from an application viewpoint appear as just one state that may be 
have substates like Analysing and Active. The digit collection task in state Analysing state may be viewed 
as a specialised task that may not at all be applicable in some networks and therefore here described as 
being a state on its own. 
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6.10.3.1 Originating Call Leg 



Originating Call Leg. 



All States 



'originating call attempt authorized 



attach Media 
detach Media 



'release' 
'timer expiry' 



deasign 



'Address_Collected' 




IpAppMultiPartyCallControlManager. 
reportNotification(originatingCallAttempl 



IpAppMultiPartyCallControlManager. 
reportNotification( originatingCallAttemptAuth orized ) 



IpAppMultiPartyCallControlManager. 
reportNotification( address_collected ) 



(originating service_code' 



IpAppMultiPartyCallControlManager. 
reportNotification( address_analysed ) 

IpAppMultiPartyCallControlManager. 
reportNotification(originating service code) 



'network release' 



Releasing 



do/ send reports if requested, or error reports if required 



'^IpAppCallLeg.callLegEnded 



<^ 



IpAppMultiPartyCallControl Manager. 

reportNotification( originating 

release ) 



^ 



Transitions/events not shown: 

All states: 

continueProcessing, getLastRedirectedAddress, getCall: no state change 

All states except Releasing: 

eventReportReq, setAdviceOfCharge, getlnfoReq, superviseReq, 

setChargePlan 



Figure : Originating Leg 

6.10.3.1.1 Initiating State 

Entry events: 

Sending of a reportNotification() method by the IPMultipartyCallControlManager for an 
"Originating_Call_Attempt" initial notification criterion. 
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- Sending of a reportNotification() method by the IPMultipartyCallControlManager for an 
"Originating_Call_Attempt_Authorised" initial notification criterion. 

Functions: 

In this state the network checks the authority/abihty of the party to place the connection to the remote (destination) 
party with the given properties, e.g. based on the originating party's identity and service profile. 

The setup of the connection for the party has been initiated and the application activity timer is being provided. 

The figure below shows the order in which network events may be detected in the Initiating state and depending on the 
monitor mode be reported to the application. 




NOTE 1 : Event oCA only applicable as an initial notification . 

NOTE 2: The release event (oREL) can occur in any state resulting in a transition to Releasing state. 

Abbreviations used for the events: 

oCA Originating Call Attempt; 

oCAA Originating Call Attempt Authorized; 

AC Address Collected, 

oREL Originating Release. 

Figure : Application view on event reporting order in Initiating State 

In this state the following functions are applicable: 

The detection of a "Originating_Call_Attempt" initial notification criterion. 

The detection of an "Originating_Call_Attempt_ Authorised" initial notification criterion as a result that the call 
attempt authorisation is successful. 

- The report of the "Originating_Call_Attempt_ Authorised" event indication whereby the following functions are 
performed: 

i) When the P_CALL_MONITOR_MODE_INTERRUPT is requested for the call leg event 

P_CALL_EVENT_CALL_ATTEMPT_AUTHORISED then the event is intercepted and call leg processing 
is suspended. 

ii) When the P_CALL_MONITOR_MODE_NOTIFY is requested for the call leg event 

P_CALL_EVENT_CALL_ATTEMPT_AUTHORISED then the event is notified and call leg processing 
continues. 

iii) When the P_CALL_MONITOR_MODE_DO_NOT_MONITOR is requested for the call leg event 

P_CALL_EVENT_CALL_ATTEMPT_AUTHORISED then no monitoring is performed. 
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- The receipt of destination address information, i.e. initial information package/dialling string as received from 
calling party. 

- Resumption of suspended call leg processing occurs on receipt of a continueProcessingO method. 

Exit events: 

Availability of destination address information, i.e. the initial information package/dialling string received from 
the calling party. 

- Application activity timer expiry indicating that no requests from the application have been received during a 
certain period. 

- Receipt of a deassign() method. 

Receipt of a release() method. 
Detection of a "originating release" indication as a result of a premature disconnect from the calling party. 

6.10.3.1.2 Analysing State 

Entry events: 

- Availability of an "Address_Collected" event indication as a result of the receipt of the (complete) initial 
information package/dialling string from the calling party. 

- Sending of a reportNotification() method by the IPMultipartyCallControlManager for an "Address_Collected" 
initial notification criterion. 

Functions: 

In this state the destination address provided by the calling party is collected and analysed. 

The received information (dialled address string from the calling party) is being collected and examined in accordance 
to the dialling plan in order to determine end of address information (digit) collection. Additional address digits can be 
collected. Upon completion of address collection the address is analysed. 

The address analysis is being made according to the dialling plan in force to determine the routing address of the call 
leg connection and the connection type (e.g. local, transit, gateway). 

The request (with eventReportReq method) to collect a variable number of more address digits and report them to the 
application (within eventReportRes method)) is handled within this state. The collection of more digits as requested and 
the reporting of received digits to the application (when the digit collect criteria is met) is done in this state. This action 
is recursive, e.g. the application could ask for 3 digits to be collected and when report request can be done repeatedly, 
e.g. the application may for example request first for 3 digits to be collected and when reported request further digits. 

The figure below shows the order in which network events may be detected in the Analysing state and depending on the 
monitor mode be reported to the application. 



ETSI 



3GPP TS 29.198-4 version 4.1.0 Release 4 



105 



ETSI TS 129 198-4 V4.1.0 (2001-09) 





Analysing 
State 


Notel 








OREL 








^ 




1 










oCAA __ 


AC 




AA 




w 




W 

















NOTE 1 : The release event (oREL) can occur in any state resulting in a transition to Releasing state. 

Abbreviations used for the events: 

oCAA Originating Call Attempt Authorized; 

AC Address Collected; 

AA Address Analysed; 

oREL Originating Release. 

Figure : Application view on event reporting order in Analysing State 



In this state the following functions are applicable: 

- The detection of a "Address_Collected" initial notification criterion. 

On receipt of the "Address_Collected" indication the following functions are performed: 

i) When the P_CALL_MONITOR_MODE_INTERRUPT is requested for the call leg event 

P_CALL_EVENT_ADDRESS_COLLECTED then the event is intercepted and call leg processing is 
suspended. 

ii) When the P_CALL_MONITOR_MODE_NOTIFY is requested for the call leg event 

P_CALL_EVENT_ADDRESS_COLLECTED then the event is notified and call leg processing continues. 

iii) When the P_CALL_MONITOR_MODE_DO_NOT_MONITOR is requested for the call leg event 

P_CALL_EVENT_ADDRESS_COLLECTED then no monitoring is performed. 

Receipt of a eventReportReqO method defining the criteria for the events the call leg object is to observe. 

- Resumption of suspended call leg processing occurs on receipt of a continueProcessingO or a routeReqO 
method.£'x// events: 

- Detection of an "Address_Analysed" indication as a result of the availability of the routing address and nature 
of address. 

- Receipt of a deassign() method. 

Receipt of a release() method. 
Detection of a "originating release" indication as a result of a premature disconnect from the calling party. 

6.10.3.1.3 Active State 

Entry events: 

- Receipt of an "Address_Analysed" indication as a result of the availability of the routing address and nature of 
address. 

Sending of a reportNotification() method by the IPMultipartyCallControlManager for an "Address_Analysed 
initial indication criterion. 

Functions: 
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In this state the call leg connection to the calling party exists and originating mid call events can be received. 

The figure below shows the order in which network events may be detected in the Active state and depending on the 
monitor mode be reported to the application. 





See Notel 




See 

Note2 








oSC 


\ 








a 




^ 


AC 




^ 


OREL 


^ 


AA " 




W 


■^ Active 
State 


w 

















NOTE 1 : Only the detected service code or the range to which the service code belongs is disarmed as the service 

code is reported to the application 
NOTE 2: The release event (oREL) can occur in any state resulting in a transition to Releasing state. 

Abbreviations used for the events: 
AC Address Collected; 

AA Address Analysed; 

oSC Originating Service Code; 

oREL Originating Release. 

Figure : Application view on event reporting order Active State 

In this state the following functions are applicable: 

- The detection of a Address_Analysed initial indication criterion. 

On receipt of the "Address_Analysed" indication the following functions are performed: 

i) When the P_CALL_MONITOR_MODE_INTERRUPT is requested for the call leg event 

P_CALL_EVENT_ADDRESS_ANALYSED then the event is intercepted and call leg processing is 
suspended. 

ii) When the P_CALL_MONITOR_MODE_NOTIFY is requested for the call leg event 

P_CALL_EVENT_ADDRESS_ANALYSED then the event is notified and call leg processing continues. 

iii) When the P_CALL_MONITOR_MODE_DO_NOT_MONITOR is requested for the call leg event 
P_CALL_EVENT_ADDRESS_ANALYSED then no monitoring is performed. 

- Resumption of suspended call leg processing occurs on receipt of a continueProcessingO method. 

- In this state the routing information is interpreted, the authority of the calling party to establish this connection is 
verified and the call leg connection is set up to the remote party. 

- In this state a connection to the call party is established. 

- Detection of a "terminating release" indication (not visible to the application) from remote party caused by a 
network release event propagated from a terminating call leg causing the originating call leg STD to transit to 
Releasing state: 

- Detection of a premature disconnect from the calling party. 

- Receipt of a deassign() method. 
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- Receipt of a release() method. 

- Detection of an "Answer" indication as a result of the remote party being connected (answered). 

- Sending of a reportNotification() method by the IPMultipartyCallControlManager for an "Answer" initial 
indication criterion. 

On receipt of the "originating_service code" indication the following functions are performed: 

i) When the P_CALL_MONITOR_MODE_INTERRUPT is requested for the call leg event 

P_CALL_EVENT_ORIGINATING_SERVICE_CODE then the event is intercepted and call leg processing 
is suspended. 

ii) When the P_CALL_MONITOR_MODE_NOTIFY is requested for the call leg event 

P_CALL_EVENT_ORIGINATING_SERVICE_CODED then the event is notified and call leg processing 
continues.. 

iii) When the P_CALL_MONITOR_MODE_DO_NOT_MONITOR is requested for the call leg event 
P_CALL_EVENT_ORIGINATING_SERVICE_CODE then no monitoring is performed. 

Resumption of suspended call leg processing occurs on receipt of a continueProcessingO method. 

Exit events: 

- Detection of an "originating release" indication as a result of a disconnect from the calling party and and an 
"terminating release" indication as a result of a disconnect from called party. 

- Receipt of a deassign() method. 

- Receipt of a release() method from the application. 

6.10.3.1.4 Releasing State 

Entry events: 

- Detection of an "Originating_Release" or "Terminating Release" indication as a result of the network release 
initiated by calling party of called party.. 

- Reception of the release() method from the application. 

Sending of a reportNotification() method by the IPMultipartyCallControlManager for an "Originating_Release" 
initial indication criterion. 

- A transition due to fault detection to this state is made when the Call leg object is in a state and no requests from 
the application have been received during a certain time period (timer expiry). 

Functions: 

In this state the connection to the call party is released as requested by the network or by the applicationand the reports 
are processed and sent to the application if requested. 

When the Releasing state is entered the order of actions to be performed is as follows: 

i) the network release event handling is performed. 

ii) the possible call leg information requested with getlnfoReqO and/ or superviseReqO is collected and send to 
the application. 

iii) the callLegEnded() method is sent to the application to inform that the call leg object is destroyed. 

Where the entry to this state is caused by the application, for example because the application has requested the leg to 
be released or deassigned or a fault (e.g. timer expiry, no response from application) has been detected, then i) is not 
applicable. In the fault case for action ii) error report methods are sent to the application for any possible requested 
reports. 
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In this state the following functions are applicable: 

The detection of a "originating_release" initial indication criterion.. 

- On receipt of the "originating_release" indication the following functions are performed: 

The network release event handling is performed as follows: 

i) When the P_CALL_MONITOR_MODE_INTERRUPT is requested for the call leg event 

P_CALL_EVENT_RELEASE then the event is intercepted and call leg processing is suspended. 

ii) When the P_CALL_MONITOR_MODE_NOTIFY is requested for the call leg event 
P_CALL_EVENT_RELEASE then the event is notified and call leg processing continues. 

iii) When the P_CALL_MONITOR_MODE_DO_NOT_MONITOR is requested for the call leg event 
P_CALL_EVENT_RELEASE then no monitoring is performed. 

Resumption of suspended call leg processing occurs on receipt of a continueProcessingO method. 

The possible call leg information requested with the getlnfoReqO and/or superviseReqO is collected and sent to 
the application with respectively the getInfoRes() and/or superviseRes() methods. 

The callLegEndedO method is sent to the application after all information has been sent. In case that the 
application has not requested additional call leg related information the call leg object is destroyed immediately 
and additionally the application will also be informed that the connection has ended 

In case of abnormal termination due to a fault and the application requested for call leg related information 
previously, the application will be informed that this information is not available and additionally the 
application is informed that the call leg object is destroyed (callLegEnded). 

Note: the call in the network may continue or be released, depending e.g. on the call state. 

- In case the release() method is received in Releasing state it will be discarded. The request from the application 
to release the leg is ignored in this case because release of the leg is already ongoing. 

Exit events: 

- In case that the application has not requested additional call leg related information the call leg object is 
destroyed immediately and additionally the application is informed that the call leg connection has ended, by 
sending the callLegEnded() method. 

- Detection of the sending of the last call leg information to the application the Call Leg object is destroyed and 
additionally the application is informed that the call leg connection has ended, by sending the callLegEnded() method. 
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6.10.3.1 .5 Overview of allowed methods, Originating Call Leg STD 



state 


methods allowed 


Initiating 


attachMedia (as a request), 

detachMedia, (as a request) 

getCall , getLastRedirectedAddress, continueProcessing, 

release (call leg), 

deassign 

eventReportReq, 

getlnfoReq, 

setChargePlan, setAdviceOfCharge, 

superviseReq 


Analysing 


attachMedia (as a request), 

detachMedia, (as a request) 

getCall , getLastRedirectedAddress, continueProcessing, 

release (call leg), 

deassign 

eventReportReq, 

getlnfoReq, 

setChargePlan, setAdviceOfCharge, 

superviseReq 


Active 


attachMedia, 

detachMedia, 

getCall , getLastRedirectedAddress, continueProcessing, 

release deassign 

eventReportReq, 

getlnfoReq, 

setChargePlan, setAdviceOfCharge, 

superviseReq 


Releasing 


getCall , getLastRedirectedAddress, continueProcessing, 
release 
deassign 
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6.10.3.2 Terminating Call Leg 



Terminating Call Leg. 



All States 
(terminating) 



Idle 
(terminating) 



routeReq 



'terminating call attempt authorize! 
'alerting', 'answer', 'terminating s^r\|ic» 
code', 'redirected', 'queued' 



attach Media/ 
detach Media v 



Active 
(terminating) 



IpMultiPartyCall.createCallLeg 



IpAppMultiPartyCallControlManager. 

eportNotification( "terminating call 

attempt", "terminating call attempt 

authorised", "alerting", "answer", 

"terminating service code", 

"redirected", "queued" ) 



'networh release' 



JL_ 



IpMultiPartyCall.createAndl^outeCallLegReq 



release 



'timer expiry' 



Releasing (terminating) 
do/ send reports if requested, or error reports if requirejd 



IpAppMultiPartyCallControlManager. 

reportNotification( terminating 

release) 



'^IpAppCallLeg.callLegEnded 
deasign 



Transitions/events not shown: ^ 

All states: 

continueProcessing, getLastRedirectedAddress, getCall, sending getlnfoRes, 

superviseRes: no state change. 

All states except Releasing: 

eventReportReq, setAdviceOfCharge, getlnfoReq, superviseReq, setChargePlan 

When the application is notified in reportNotfication of an call related network event 
associated with the Terminating Call Leg STD, then the Originating Call Leg STD is 
created and is initialized to be in the Active state. 



Figure : Terminating Leg 

6.10.3.2.1 Idle (terminating) State 

Entry events: 

Receipt of a createCallLegO method to start an application initiated call leg connection. 
Functions: 

In this state the call leg object is created and the interface connection is idled. 
The application activity timer is being provided. 

In this state the following functions are applicable: 

Invoking routeReq will result in a request to actually route the call leg object. 
- Resumption of call leg processing occurs on receipt of a routeReqO method. 
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Exit events: 

- Receipt of a routeReqO method from the application. 

- Application activity timer expiry indicating that no requests from the application have been received during a 
certain period to continue processing. 

- Receipt of a deassign() method. 

- Receipt of a release() method. 

- Detection of a network release event being an "originating release" indication as a result of a premature disconnect 
from the calling party. 

6.10.3.2.2 Active (terminating) State 

Entry events: 

Receipt of an routeReq will result in actually routing the call leg object. 

Receipt of a createAndRouteCallLegO method to start an application initiated call leg connection. 

Sending of a reportNotification() method by the IPMultipartyCallControlManager for an 
"Terminating_Call_Attempt" trigger criterion. 

Sending of a reportNotification() method by the IPMultipartyCallControlManager for an 
"Terminating_Call_Attempt_Authorized" trigger criterion. 

Functions: 

In this state the routing information is interpreted, the authority of the called party to establish this connection is verified 
for the call leg connection. In this state a connection to the call party is established whereby events from the network 
may indicate to the application when the party is alerted (acknowledge connection setup) and when the party answer 
(confirmation of connection setup). 

Furthermore, in this state terminating service code events can be received. 



The figure below shows the order in which network events may be detected in the Active state and depending on the 
monitor mode be reported to the application. 
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NOTE 1 : Event tCA applicable as initial notification 

NOTE 2: Only the detected service code or the range to which the service code belongs is disarmed as the service 

code is reported to the application 
NOTE 3: The release event (tREL) can occur in any state resulting in a transition to Releasing state. 

Abbreviations used for the events: 

tCA Terminating Call Attempt; 

tCAA Terminating Call Attempt Authorized; 

AL Alerting; 

ANS Answer; 

tREL Terminating Release; 

Q Queued; 

RD Redirected; 

tSC Terminating Service Code. 

Figure : Application view on event reporting order in Active State 

In this state the following functions are applicable: 

The detection of an "Terminating_Call_ Attempt" initial notification criterion as a result that the call attempt. 

The detection of an "Terminating_Call_Attempt_ Authorised" initial notification criterion as a result that the 
call attempt authorisation is successful. 

The report of the "Terminating_Call_Attempt_Authorised" event indication whereby the following functions are 
performed: 

i) When the P_CALL_MONITOR_MODE_INTERRUPT is requested for the call leg event 

P_CALL_EVENT_TERMINATING_CALL_ATTEMPT_AUTHORISED then the event is intercepted and 
call leg processing is suspended. 

ii) When the P_CALL_MONITOR_MODE_NOTIFY is requested for the call leg event 

P_CALL_EVENT_TERMINATING_CALL_ATTEMPT_AUTHORISED then the event is notified and call 
leg processing continues. 

iv) When the P_CALL_MONITOR_MODE_DO_NOT_MONITOR is requested for the call leg event 

P_CALL_EVENT_CALL_TERMINATING_ATTEMPT_AUTHORISED then no monitoring is 
performed. 

Detection of an "Queued" indication as a result of the call to remote party being queued. 

- On receipt of the "Queued" indication the following functions are performed: 

i) When the P_CALL_MONITOR_MODE_INTERRUPT is requested for the call leg event 

P_CALL_EVENT_QUEUED then the event is intercepted and call leg processing is suspended. 
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ii) When the P_CALL_MONITOR_MODE_NOTIFY is requested for the call leg event 
P_CALL_EVENT_QUEUED then the event is notified and call leg processing continues. 

iii) When the P_CALL_MONITOR_MODE_DO_NOT_MONITOR is requested for the call leg event 

P_CALL_EVENT_QUEUED then no monitoring is performed. 

Sending of a reportNotification() method by the IPMultipartyCallControlManager for an "Alerting" trigger 
criterion. 

- On receipt of the "Alerting" indication the following functions are performed: 

i) When the P_CALL_MONITOR_MODE_INTERRUPT is requested for the call leg event 

P_CALL_EVENT_ALERTING then the event is intercepted and call leg processing is suspended. 

ii) When the P_CALL_MONITOR_MODE_NOTIFY is requested for the call leg event 

P_CALL_EVENT_ALERTING then the event is notified and call leg processing continues. 

iii) When the P_CALL_MONITOR_MODE_DO_NOT_MONITOR is requested for the call leg event 
P_CALL_EVENT_ALERTING then no monitoring is performed. 

Sending of a reportNotification() method by the IPMultipartyCallControlManager for an "Answer" trigger 
criterion. 

Detection of an "Answer" indication as a result of the remote party being connected (answered). 

On receipt of the "Answer" indication the following functions are performed: 

i) When the P_CALL_MONITOR_MODE_INTERRUPT is requested for the call leg event 

P_CALL_EVENT_ANSWER then the event is intercepted and call leg processing is suspended. 

ii) When the P_CALL_MONITOR_MODE_NOTIFY is requested for the call leg event 
P_CALL_EVENT_ANSWER then the event is notified and call leg processing continues. 

iv) When the P_CALL_MONITOR_MODE_DO_NOT_MONITOR is requested for the call leg event 

P_CALL_EVENT_ANSWER then no monitoring is performed. 

Sending of a reportNotification() method by the IPMultipartyCallControlManager for an "service_code" trigger 
criterion. 

- The detection of a "service_code" trigger criterion suspends call leg processing. 

On receipt of the "service code" indication the following functions are performed: 

i) When the P_CALL_MONITOR_MODE_INTERRUPT is requested for the call leg event 

P_CALL_EVENT_TERMINATING_SERVICE_CODE then the event is intercepted and call leg processing 
is suspended. 

ii) When the P_CALL_MONITOR_MODE_NOTIFY is requested for the call leg event 

P_CALL_EVENT_TERMINATING_SERVICE_CODE then this is not a valid event (that event is not 
notified) and call leg processing continues. 

iii) When the P_CALL_MONITOR_MODE_DO_NOT_MONITOR is requested for the call leg event 

P_CALL_EVENT_TERMINATING_SERVICE_CODE then no monitoring is performed. 

On receipt of the "redirected" indication the following functions are performed: 

i) When the P_CALL_MONITOR_MODE_INTERRUPT is requested for the call leg event 

P_CALL_EVENT_REDIRECTED then the event is intercepted and call leg processing is suspended. 

ii) When the P_CALL_MONITOR_MODE_NOTIFY is requested for the call leg event 

P_CALL_EVENT_REDIRECTED then this is not a valid event (that event is not notified) and call leg 
processing continues. 

iii) When the P_CALL_MONITOR_MODE_DO_NOT_MONITOR is requested for the call leg event 
P_CALL_EVENT_REDIRECTED then no monitoring is performed. 
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- Resumption of call leg processing occurs on receipt of a continueProcessingO method. 
Exit events: 

- Detection of a network release event being an "terminating release" indication as a result of the following 
events: 

i) Unable to select a route or indication from the remote party of the call leg connection cannot be presented 
(this is the network determined busy condition) 

ii) Occurrence of an authorisation failure when the authority to place the call leg connection was denied (e.g. 
business group restriction mismatch). 

iii) Detection of a route busy condition received from the remote call leg connection portion. 

iv) Detection of a no-answer condition received from the remote call leg connection portion. 

iv) Detection that the remote party was not reachable. 

- Detection of a network release event being an "originating release" indication as a result of the following events: 
vi) Detection of a premature disconnect from the calling party. 

- Receipt of a deassign() method. 

- Receipt of a release() method from the application. 

- Detection of a netwok release event being an "originating release" indication as a result of a disconnect from the 
calling party or a "terminating release" indication as a result of a disconnect from the called party. 

6.10.3.2.3 Releasing (terminating) State 

Entry events: 

- Detection of a network release event being an "originating release" indication as a result of the network release 
initiated by calling party or a "terminating release" indication as a result of the network release initiated by 
called party.. 

- Sending of the release() method by the application. 

Sending of a reportNotification() method by the IPMultipartyCallControlManager for an "Terminating Release" 
trigger criterion. 

A transition due to fault detection to this state is made when the Call leg object awaits a request from the 
application and this is not received within a certain time period. 

- Detection of a network event being a "terminating release" indication as a result of the following events: 

i) Unable to select a route or indication from the remote party of the call leg connection cannot be presented 
(this is the network determined busy condition) 

ii) Occurrence of an authorisation failure when the authority to place the call leg connection was denied (e.g. 
business group restriction mismatch). 

iii) Detection of a route busy condition received from the remote call leg connection portion. 

iv) Detection of a no-answer condition received from the remote call leg connection portion. 

v) Detection that the remote party was not reachable. 

- Detection of a network release event being an "originating release" indication as a result of the following events: 
vi) Detection of a premature disconnect from the calling party. 

Functions: 
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In this state the connection to the call party is released as requested by the network or by the application 
and the reports are processed and sent to the application if requested . 

When the Releasing state is entered the order of actions to be performed is as follows: 

i) the release event handling is performed. 

ii) the possible call leg information requested with getlnfoReqO and/ or superviseReqO is collected and send to the 
application. 

iii) the callLegEnded() method is sent to the application to inform that the call leg object is destroyed. 

Where the entry to this state is caused by the application, for example because the application has requested the leg to 
be released or deassigned or a fault (e.g. timer expiry, no response from application) has been detected, then i) is not 
applicable. In the fault case for action ii) error report methods are sent to the application for any possible requested 
reports. 

In this state the following functions are applicable: 

The detection of a "Terminating Release" trigger criterion. 

- On receipt of the network release event being a "Terminating Release" indication the following functions are 
performed: 

The network release event handling is performed as follows: 

i) When the P_CALL_MONITOR_MODE_INTERRUPT is requested for the call leg event 

P_CALL_EVENT_TERMINATING_RELEASE then the event is intercepted and call leg processing is 
suspended. 

ii) When the P_CALL_MONITOR_MODE_NOTIFY is requested for the call leg event 

P_CALL_EVENT_TERMINATING_RELEASE then the event is notified and call leg processing 
continues. 

iii) When the P_CALL_MONITOR_MODE_DO_NOT_MONITOR is requested for the call leg event 
P_CALL_EVENT_TERMINATING_RELEASE then no monitoring is performed. 

Resumption of suspended call leg processing occurs on receipt of a continueProcessingO method. 

The possible call leg information requested with the getlnfoReqO and/or superviseReqO is collected and sent to 
the application with respectively the getInfoRes() and/or superviseRes() methods. 

The callLegEndedO method is sent to the application after all information has been sent. In case that the 
application has not requested additional call leg related information the call leg object is destroyed immediately 
and additionally the application will also be informed that the connection has ended 

In case of abnormal termination due to a fault and the application requested for call leg related information 
previously, the application will be informed that this information is not available and additionally the 
application is informed that the call leg object is destroyed (callLegEnded). 

Note: the call in the network may continue or be released, depending e.g. on the call state. 

In case the release() method is received in Releasing state it will be discarded. The request from the 
application to release the leg is ignored in this case because release of the leg is already ongoing. 

Exit events: 

- In case that the application has not requested additional call leg related information the call leg object is 
destroyed immediately and additionally the application is informed that the call leg connection has ended, by 
sending the callLegEnded() method. 

- Detection of the sending of the last call leg information to the application the Call Leg object is destroyed and 
additionally the application is informed that the call leg connection has ended, by sending the callLegEnded() method. 
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eventReportReq 
getlnfoReq 



"incoming call event" "IpAppMultiPartyCallControlManager.callEventNotify 



IpMultiPartyCall.cre^AndRouteCallLeg 
l.createCallLeg 




6.10.3.2.4 Overview of allowed methods and trigger events, Terminating Call Leg STD 



state 


methods allowed 


Idle 


routeReq, 

getCall , getLastRedirectedAddress, 

release, 

deassign 

eventReportReq, 

getlnfoReq, 

setChargePlan, setAdviceOfCharge, 

superviseReq 


Active 


attachMedia 
detachMedia 
getCall , getLastRedirectedAddress, continueProcessing, 

release, 

deassign 

eventReportReq, 

getlnfoReq, 

setChargePlan, setAdviceOfCharge, 

superviseReq 


Releasing 


- getCall , getLastRedirectedAddress, continueProcessing, 
release, 
deassign 
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6.1 1 Multi-Party Call Control Service Properties 
6.1 1 .1 List of Service Properties 

The following table lists properties relevant for the MPCC API. These properties are additional to the properties of the 
GCC, from which the MPCC is an extension. 



Property 


Type 


Description 


P_MAX_CALLLEGS_PER_CALL 


INTEGER_SET 


Indicates how many parties can be in one call. 


P_UI_CALLLEG_BASED 


BOOLEAN_SET 


Value = TRUE : User interaction can be performed on leg level and a 
reference to a CallLeg object can be used in the 
IpUIManager.createUICallO operation. 
Value = FALSE : No user interaction on leg level is supported. 


P_ROUTING_WITH_CALLLEG_OPERATIONS 


BOOLEAN_SET 


Value = TRUE : the atomic operations for routing a CallLeg are supported 

{ IpMultiPartyCall.createCallLegO, IpCallLeg.eventReportReqO, 

IpCallLeg.routeO, IpCallLeg.attachMedia() } 

Value = FALSE : the convenience function has to be used for routing a 

CallLeg. 


P_MEDIA_ATTACH_EXPLICIT 


BOOLEAN_SET 


Value = TRUE : the CallLeg shall be expHcitly attached to a Call. 
Value = FALSE : the CallLeg is automatically attached to a Call, no 
IpCallLeg.attachMediaO is needed when a party answers. 



6.1 1 .2 Service Property values for the CAMEL Service Environment. 

Implementations of the MultiParty Call Control API relying on the CSE shall have the Service Properties outlined 
above set to the indicated values : 

P_OPERATION_SET = { 

'^IpMultiPartyCallControlManager . createNotif ication'', 

'^IpMultiPartyCallControlManager . destroyNotif ication'', 

'^IpMultiPartyCallControlManager . changeNotif ication'', 

''IpMultiPartyCallControlManager . getNotif ication'% 

''IpMultiPartyCallControlManager . setCallLoadControl'' 

''IpMultiPartyCall . getCallLegs'', 

''IpMultiPartyCall . createCallLeg'', 

''IpMultiPartyCall . createAndRouteCallLegReq'% 

''IpMultiPartyCall . release'^ 

'^IpMultiPartyCall . deassignCall'', 

''IpMultiPartyCall . getinf oReq'', 

''IpMultiPartyCall . setChargePlan'^ 

''IpMultiPartyCall . setAdviceOf Charge'', 

'^IpMultiPartyCall . superviseReq'% 

'^IpCallLeg. routeReq'', 

'^IpCallLeg. eventReportReq'', 

'^IpCallLeg. release'% 

'^IpCallLeg. getinf oReq'% 

''IpCallLeg.getCall'', 

'^IpCallLeg. continueP recessing'' 

} 

P_TRIGGERING_EVENT_TYPES = { 

P_CALL_EVENT_CALL_AT TEMPT, 

P_CALL_EVENT_ADDRESS_COLLECTED, 

P_CALL_EVENT_ADDRESS_ANALYSED, 

P_CALL_EVENT_RELEASE , 

} 

P_DYNAMIC_EVENT_TYPES = { 

P_CALL_EVENT_ANSWER, 

P_CALL_EVENT_RELEASE 

} 

P_ADDRESS_PLAN = { 

P_ADDRESS_PLAN_E164 

} 

P_UI_CALL_BASED = { 

TRUE 

} 
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P_UI_AT_ALL_STAGES 
FALSE 



P_MEDIA_TYPE 
P_AUDIO 



P_MAX_CALLLEGS_PER_CALL = { 

0, 

2 

} 

P_UI_CALLLEG_BASED = { 
FALSE 



P_MEDIA_ATTACH_EXPLICIT = { 
FALSE 
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6.12 Multi-Party Call Control Data Definitions 

The present document provides the MPCC data definitions necessary to support the API specification. 
The general format of a data definition specification is described below. 

• Data Type 

This shows the name of the data type. 

• Description 

This describes the data type. 

• Tabular Specification 

This specifies the data types and values of the data type. 

• Example 

If relevant, an example is shown to illustrate the data type. 

6.12.1 Event Notification Data Definitions 

No specific event notification data defined. 

6.12.2 Multi- Party Call Control Data Definitions 
IpCallLeg 

Defines the address of an IpCallLeg Interface. 

IpCallLegRef 

Defines a Reference to type IpCallLeg. 

IpCallLegRef Re f 

Defines a Reference to type IpCallLegRef. 

IpAppCallLeg 

Defines the address of an IpAppCallLeg Interface. 

IpAppCallLegRef 

Defines a Reference to type IpAppCallLeg. 

IpMultiPartyCall 

Defines the address of an IpMultiPartyCall Interface. 

IpMultiPartyCallRef 

Defines a Reference to type IpMultiPartyCall. 

IpAppMultiP arty Call 

Defines the address of an IpAppMultiP arty Call Interface. 

IpAppMultiP art yCallRef 
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Defines a Reference to type IpAppMultiPartyCall. 

IpMultiPartyCallControlManager 

Defines the address of an IpMultiPartyCallControlManager Interface. 

IpMultiPartyCallControlManagerRef 

Defines a Reference to type IpMultiPartyCallControlManager. 

IpAppMultiPartyCallControlManager 

Defines the address of an IpAppMultiPartyCallControlManager Interface. 

IpAppMultiPartyCallControlManagerRef 

Defines a Reference to type IpAppMultiPartyCallControlManager.. 

TpAppCallLegRefSet 

Defines a Numbered Set of Data Elements of IpAppCallLegRef. 

IpAppCallLegRef 

Defines a Reference to type IpAppCallLegRef. 

IpAppMultiPartyCallRef 

Defines a Reference to type IpAppMultiPartyCallRef. 

TpMultiPartyCallldentifier 

Defines the Sequence of Data Elements that unambiguously specify the Call object 



Sequence Element 
Name 


Sequence Element 
Type 


Sequence Element 
Description 


CallReference 


IpMultiPartyCallRef 


This element specifies the interface reference for the Multi-party call object. 


CallSessionID 


TpSessionID 


This element specifies the call session ID. 



TpMultiPartyCallldentifierRef 

Defines a Reference to type TpMultiPartyCallldentifier. 

TpAppMultiPartyCallBack 

Defines the Tagged Choice of Data Elements that references the application callback interfaces 





Tag Element Type 






TpAppMultiPartyCallBackRefType 





ETSI 



3GPP TS 29.198-4 version 4.1.0 Release 4 



121 



ETSI TS 129 198-4 V4.1.0 (2001-09) 



Tag Element Value 


Choice Element Type 


Choice Element Name 


P_APP_CALLBACK_UNDEFINED 


NULL 


Undefined 


P_APP_MULTIPARTY_CALL_CALLBACK 


IpAppMultiPartyCallRef 


appMultiPartyCall 


P_APP_CALL_LEG_CALLBACK 


IpAppCallLegRef 


appCallLeg 


P_APP_CALL_AND_CALL_LEG_CALLBACK 


TpAppCallLegCallBack 


appMultiPartyCallAndCallLeg 



TpAppMultiP art yCallBackRef Type 

Defines the type application call back interface. 



Name 


Value 


Description 


P_APP_CALLBACK_UNDEFINED 





Application Call back interface undefined 


P_APP_MULTIPARTY_CALL_CALLBACK 


1 


Application Multi-Party Call interface 
referenced 


P_APP_CALL_LEG_CALLBACK 


2 


Application CallLeg interface referenced 


P_APP_CALL_AND_CALL_LEG_CALLBACK 


3 


Application Multi-Party Call and CallLeg 
interface referenced 









TpAppCallLegCallBack 

Defines the Sequence of Data Elements that references a call and a call leg application interface. 



Sequence Element Name 


Sequence Element Type 




appMultiPartyCall 


IpAppMultiPartyCallRef 




appCallLegSet 


TpAppCallLegRefSet 


Specifies the set of all call leg call back 

references. First in the set is the reference 

to the call back of the originating callLeg. 

In case there is a call back to a destination 

call leg this will be second in the set. 















TpMultiPartyCallldentifierSet 

Defines a Numbered Set of Data Elements of TpMultiPartyCallldentifier. 

TpMultiPartyCallldentifierSetRef 

Defines a Reference to type TpMultiPartyCallldentifierSet. 

TpCallAppInfo 

Defines the Tagged Choice of Data Elements that specify application-related call information. 





Tag Element Type 






TpCallAppInfoType 
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Tag Element 
Value 


Choice Element 
Type 


Choice Element 
Name 


P_CALL_APP_ALERTING_MECHANISM 


TPCallAlertingMechanism 


CallAppAlertingMechanism 


P_CALL_APP_NETWORK_ACCESS_TYPE 


TpCallNetworkAccessType 


CallAppNetworkAccessType 








P_CALL_APP_TELE_SERVICE 


TpCallTeleService 


CallAppTeleService 


P_CALL_APP_BEARER_SERVICE 


TpCallBearerService 


CallAppBearer Service 


P_CALL_APP_P ART Y_CATE GORY 


TpCallPartyCategory 


CallAppPartyCategory 


P_CALL_APP_PRESENTATION_ADDRESS 


TpAddress 


CallAppPresentationAddress 


P_CALL_APP_GENERIC_INFO 


TpString 


CallAppGenericInfo 


P_CALL_APP_ADDITIONAL_ADDRESS 


TpAddress 


CallAppAdditionalAddress 


P_CALL_APP_ORIGINAL_DESTINATION_ADDRESS 


TpAddress 


CallAppOriginalDestinationAddress 


P_CALL_APP_REDIRECTING_ADDRESS 


TpAddress 


CallAppRedirectingAddress 



TpCallAppInfoType 

Defines the type of call application-related specific information. 



Name 


Value 


Description 


P_CALL_APP_UNDEFINED 





Undefined 


P_CALL_APP_ALERTING_MECHANISM 


1 


The alerting mechanism or pattern to use 


P_CALL_APP_NETWORK_ACCESS_TYPE 


2 


The network access type (e.g. ISDN) 








P_CALL_APP_TELE_SERVICE 


3 


Indicates the tele-service (e.g. telephony) 


P_CALL_APP_BEARER_SERVICE 


4 


Indicates the bearer service (e.g. 64 kbit/s unrestricted data). 


P_CALL_APP_P ART Y_CATE GORY 


5 


The category of the caUing party 


P_CALL_APP_PRESENTATION_ADDRESS 


6 


The address to be presented to other call parties 


P_CALL_APP_GENERIC_INFO 


7 


Carries unspecified service-service information 


P_CALL_APP_ADDITIONAL_ADDRESS 


8 


Indicates an additional address 


P_CALL_APP_ORIGINAL_DESTINATION_ADDRESS 


9 


Contains the original address specified by the originating user when 
launching the call. 


P_CALL_APP_REDIRECTING_ADDRESS 


10 


Contains the address of the user from which the call is diverting. 



TpCallAppInfoSet 

Defines a Numbered Set of Data Elements of TpCallAppInfo. 



TpCallEventRequest 

Defines the Sequence of Data Elements that specify the criteria relating to call report requests. 



Sequence Element Name 


Sequence Element Type 


CallEventType 


TpCallEventType 


AdditionalCallEvent Criteria 


TpAdditionalCallEventCriteria 


CallMonitorMode 


TpCallMonitorMode 



TpCallEventRequestSet 

Defines a Numbered Set of Data Elements of TpCallEventRequest. 

TpCal IE vent Type 

Defines a specific call event report type. 
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Name 


Value 


Description 


P_CALL_EVENT_UNDEF INED 





Undefined 


P_CALL_EVENT_ORIGINATING_CALL_ATTEMPT 


1 


An originating call attempt takes place (e.g. Off-hook event). 


P_CALL_EVENT_ORIGINATING_CALL_ATTEMPT_AUTHORISED 


2 


An originating call attempt is authorised 








P_CALL_EVENT_ADDRESS_COLLECTED 


3 


The destination address has been collected. 


P_CALL_EVENT_ADDRESS_ANALYSED 


4 


The destination address has been analysed. 


P_CALL_EVENT_ORIGINATING_SERVICE_CODE 


5 


Mid-call originating service code received. 


P_CALL_EVENT_ORIGINATING_RELEASE 


6 


A originating call/call leg is released 


P_CALL_EVENT_TERMINATING_CALL_ATTEMPT 


7 


A terminating call attempt takes place 


P_CALL_EVENT_TERMINATING_CALL_ATTEMPT_AUTHORISED 


8 


A terminating call is authorized 


P_CALL_EVENT_ALERT ING 


9 


Call is alerting at the call party. 


P_CALL_EVENT_ANSWER 


10 


Call answered at address. 


P_CALL_EVENT_TERMINATING_RELEASE 


11 


A terminating Ccall leg ishas been released or the call could 
not be routed. 


P_CALL_EVENT_REDIRECTED 


12 


Call redirected to new address: an indication from the network 

that the call has been redirected to a new address (no events 

disarmed as a result of this). 


P_CALL_EVENT_TERMINATING_SERVICE_CODE 


13 


Mid call terminating service code received. 


P_CALL_EVENT_QUEUED 


14 


The Call Event has been queued, (no events are disarmed as a 
result of this) 



EVENT HANDLING RULES: 

The following general event handling rules apply to dynamically armed events: 

• If an armed event is met, then it is disarmed, unless explicit stated that it will not to be disarmed. 

• If an event is met that causes the release of the related leg, then all events related to that leg are disarmed . 

• When an event is met on a call leg irrespective of the event monitor mode, then only events belonging to that call 
leg may become disarmed (see table below) . 

• If a call is released, then all events related to that call are disarmed. 

NOTE : Event disarmed means monitor mode is set to DO_NOT_MONITOR. and 
event armed means monitor mode is set to INTERRUPT or NOTIFY.. 

The table below defines the disarming rules for dynamic events. In case such an event occurs on a call leg the table 
shows which events are disarmed (are not monitored anymore) on that call leg and should be re-armed by 
eventReportReqO in case the application is still interested in these events. 
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Event Occurred 


Events Disarmed 


P_CALL_EVENT_UNDEF INED 


Not Applicable 


P_CALL_EVENT_ORIGINATING_CALL_ATTEMPT 


Not applicable, can only be armed as trigger 


P_CALL_EVENT_ORIGINATING_CALL_ATTEMPT_AUTHORIS 
ED 


P_CALL_EVENT_ORIGINATING_CALL_ATTEMPT_AUTHORISED 


P_CALL_EVENT_ADDRESS_COLLECTED 


P_CALL_EVENT_ADDRESS_COLLECTED 


P_CALL_EVENT_ADDRESS_ANALYSED 


P_CALL_EVENT_ADDRESS_COLLECTED 
P_CALL_EVENT_ADDRESS_ANALYSED 






P_CALL_EVENT_ALERT ING 


P_CALL_EVENT_ ALERTING 

P_CALL_EVENT_TERMINATING_RELEASE with criteria: 

P_USER_NOT_AVAILABLE 

P_BUSY 

P_NOT_REACHABLE 

P_ROUTING_FAILURE 

P_C ALL_RESTRIC1 ED 

P_UNAVAILABLE_RESOURCES 


P_CALL_EVENT_ANSWER 


P_CALL_EVENT_ ALERTING 

P_CALL_EVENT_ANSWER 

P_CALL_EVENT_TERMINATING_RELEASE with criteria: 

P_USER_NOT_AVAILABLE 

P_BUSY 

P_NOT_REACHABLE 

P_ROUTING_FAILURE 

P_CALL_RESTRICTED 

P_UNAVAILABLE_RESOURCES 

P_NO_ANSWER 


P_CALL_EVENT_ORIGINATING_RELEASE 


All pending network events for the call leg are disarmed 


P_CALL_EVENT_TERMINATING_RELEASE 


All pending network events for the call leg are disarmed 


P_CALL_EVENT_ORIGINATING_SERVICE_CODE 


P_CALL_EVENT_ORIGINATING_SERVICE_CODE ^) see NOTE 1 






P_CALL_EVENT_TERMINATING_SERVICE_CODE 


P_CALL_EVENT_TERMINATING_SERVICE_CODE *) see NOTE 


NOTE 1 : Only the detected service code or the range to which the service code belongs is disarmed. I 



TpAdditionalCallEventCriteria 

Defines the Tagged Choice of Data Elements that specify specific criteria. 





Tag Element Type 






TpCallEventType 
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Tag Element 
Value 


Choice Element 
Type 


Choice Element 
Name 


P_CALL_EVENT_UNDEF INED 


NULL 


Undefined 


P_CALL_EVENT_ORIGINATING_CALL_AT TEMPT 


NULL 


Undefined 


P_CALL_EVENT_ORIGINATING_CALL_ATTEMPT_AUTHORISED 


NULL 


Undefined 


P_CALL_EVENT_ADDRESS_COLLECTED 


Tplnt32 


Min Addres sLength 


P_CALL_EVENT_ADDRESS_ANALYSED 


NULL 


Undefined 


P_CALL_EVENT_ORIGINATING_SERVICE_CODE 


TpCallServiceCode 


OriginatingServiceCode 


P_CALL_EVENT_ORIGINATING_RELEASE 


TpReleaseCauseSet 


OriginatingReleaseCauseSet 


P_CALL_EVENT_TERMINATING_CALL_ATTEMPT 


NULL 


Undefined 


P_CALL_EVENT_TERMINATING_CALL_ATTEMPT_AUTHORISED 


NULL 


Undefined 


P_CALL_EVENT_ALERT ING 


NULL 


Undefined 


P_CALL_EVENT_ANSWER 


NULL 


Undefined 


P_CALL_EVENT_TERMINATING_RELEASE 


TpReleaseCauseSet 


TerminatingReleaseCauseSet 


P_CALL_EVENT_REDIRECTED 


NULL 


Undefined 


P_CALL_EVENT_TERMINATING_SERVICE_CODE 


TpCallServiceCode 


TerminatingServiceCode 


P_CALL_EVENT_QUEUED 


NULL 


Undefined 



TpCallEventlnfo 

Defines the Sequence of Data Elements that specify the event report specific information. 



Sequence Element 
Name 


Sequence Element 
Type 


CallEventType 


TpCallEventType 


AdditionalCallEventlnfo 


TpCallAdditionalEventlnfo 


C allMonitorMode 


TpCallMonitorMode 


CallEventTime 


TpDateAndTime 



TpCallAdditionalEventlnfo 

Defines the Tagged Choice of Data Elements that specify additional call event information for certain types 
of events. 





Tag Element Type 






TpCallEventType 
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Tag Element 
Value 


Choice Element 
Type 


Choice Element 
Name 


P_CALL_EVENT_UNDEF INED 


NULL 


Undefined 


P_CALL_EVENT_ORIGINATING_CALL_ATTEMPT 


NULL 


Undefined 


P_CALL_EVENT_ORIGINATING_CALL_ATTEMPT_AUTHORISED 


NULL 


Undefined 


P_CALL_EVENT_ADDRESS_COLLECTED 


TpAddress 


CoUectedAddress 


P_CALL_EVENT_ADDRESS_ANALYSED 


TpAddress 


CalledAddress 


P_CALL_EVENT_ORIGINATING_SERVICE_CODE 


TpCallServiceCode 


OriginatingServiceCode 


P_CALL_EVENT_ORIGINATING_RELEASE 


TpReleaseCause 


OriginatingReleaseCause 


P_CALL_EVENT_TERMINATING_CALL_ATTEMPT 


NULL 


Undefined 


P_CALL_EVENT_TERMINATING_CALL_ATTEMPT_AUTHORISED 


NULL 


Undefined 


P_CALL_EVENT_QUEUED 


NULL 


Undefined 


P_CALL_EVENT_ALERT ING 


NULL 


Undefined 


P_CALL_EVENT_ANSWER 


NULL 


Undefined 


P_CALL_EVENT_TERMINATING_RELEASE 


TpReleaseCause 


TerminatingReleaseCause 


P_CALL_EVENT_REDIRECTED 


TpAddress 


ForwardAddress 


P_CALL_EVENT_TERMINATING_SERVICE_CODE 


TpCallServiceCode 


TerminatingServiceCode 



TpCallNotificationRequest 

Defines the Sequence of Data Elements that specify the criteria for an event notification 



Sequence Element Name 


Sequence Element Type 


Description 


CallNotificationScope 


TpCallNoficationScope 


Defines the scope of the notification request. 


CallEventsRequested 


TpCallEventRequestSet 


Defines the events which are requested 



TpCallNotificationScope 

Defines a the sequence of Data elements that specify the scope of a notification request. 

Of the addresses only the Plan and the AddrString are used for the purpose of matching the notifications against the 
criteria. 



Sequence Element 
Name 


Sequence Element 
Type 


Description 


DestinationAddress 


TpAddressRange 


Defines the destination address or address range for which the notification is 
requested. 


OriginatingAddress 


TpAddressRange 


Defines the origination address or address range for which the notification is 
requested. 



TpCallNotificationlnfo 

Defines the Sequence of Data Elements that specify the information returned to the appHcation in a Call 
notification report. 



Sequence Element 
Name 


Sequence Element 
Type 


Description 


CallNotificationReport Scope 


TpCallNotificationReport Scope 


Defines the scope of the notification report. 


CallAppInfo 


TpCallAppInfoSet 


Contains additonal call info. 


CallEventlnfo 


TpCallEventlnfo 


Contains the event which is reported. 



TpCallNotificationReport Scope 

Defines the Sequence of Data Element s that specify the scope for which a notification report was sent. 
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Sequence Element 
Name 


Sequence Element 
Type 


Description 


DestinationAddress 


TpAddress 


Contains the destination address of the call. 


OriginatingAddress 


TpAddress 


Contains the origination address of the call 


NotificationCallType 


TpNotificationCallType 


Indicates if the notification was reported for an originating or terminating call. 



TpNotificationRequested 

Defines the Sequence of Data Elements that specify the criteria relating to event requests. 



Sequence Element 
Name 


Sequence Element 
Type 


AppCallNotificationRequest 


TpCallNotificationRequest 


Assignment ID 


Tplnt32 



TpNotificationsRequestedSet 

Defines a numbered Set of Data Elements of TpNotificationRequested. 

TpNotificationsRequestedSetRef 

Defines a reference to the type TpNotificationsRequestSet. 

TpReleaseCause 

Defines the reason for which a call is released. 



Name 


Value 


Description 


P_UNDEFINED 





The reason of release isn't known, because no info was received from the network. 


P_USER_NOT_AVAILBLE 


1 


The user isn't available in the network. This means that the number isn't allocated or that the user 
isn't registered. 


P_BUSY 


2 


The user is busy. 


P_NO_ANSWER 


3 


No answer was received 


P_NOT_REACHABLE 


4 


The user terminal isn't reachable 


P_ROUTING_FAILURE 


5 


A routing failure occurred. For example an invalid address was received 


P_PREMATURE_DISCONNECT 


6 


The user disconnected the call / call leg during the setup phase. 


P_DISCONNECTED 


7 


A disconnect was received. 


P_CALL_RESTRICTED 


8 


The call was subject of restrictions 


P_UNAVAILABLE_RE SOURCE 


9 


The request could not be carried out as no resources were available. 


P_GENERAL_F AI LURE 


10 


A general network failure occurred. 


P_TIMER_EXPIRY 


11 


The call / call leg was released because an activity timer expired. 



TpReleaseCauseSet 

Defines a Numbered Set of Data Elements of TpCallReleaseCause. 

TpCallLegldentifier 

Defines the Sequence of Data Elements that unambiguously specify the Call Leg object. 
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Sequence Element 
Name 


Sequence Element 
Type 


Sequence Element 
Description 


CallLegReference 


IpCallLegRef 


This element specifies the interface reference for the callLeg object. 


CallLegSessionID 


TpSessionID 


This element specifies the callLeg session ID. 



TpCallLegldentifierRef 

Defines a Reference to type TpCallLegldentifier. 

TpCallLegldentifierSet 

Defines a Numbered Set of Data Elements of TpCallLegldentifier. 

TpCallLegldentifierSetRef 

Defines a Reference to type TpCallLegldentifierSet. 

TpCallLegAttachMechanism 

Defines how a CallLeg should be attached to the call. 



Name 


Value 


Description 


P_CALLLEG_ATTACH_IMPLICITLY 





CallLeg should be attached implicitly to the call. 


P_CALLLEG_ATTACH_EXPLICITLY 


1 


CallLeg should be attached expHcitly to the call by using the attachMedia() operation. This 
allows e.g. the appHcation to do first user interaction to the party before he/she is placed in the 
call. 



TpCallLegConnectionProperties 

Defines the Sequence of Data Elements that specify the connection properties of the Call Leg object 



Sequence Element 
Name 


Sequence Element 
Type 


Sequence Element 
Description 


AttachMechanism 


TpCallLegAttachMechanism 


Defines how a CallLeg should be attached to the call. 



TpCallLeglnfoReport 

Defines the Sequence of Data Elements that specify the call leg information requested. 



Sequence Element 
Name 


Sequence Element 
Type 


Description 


CallLeglnfoType 


TpCallLeglnfoType 


The type of the call leg. 


CallLegStartTime 


TpDateAndTime 


The time and date when the call leg was started (i.e. the leg was routed). 


CallLegConnectedToResourceTime 


TpDateAndTime 


The date and time when the call leg was connected to the resource. If no 

resource was connected the time is set to an empty string. 

Either this element is valid or the CallConnectedToAddressTime is valid, 

depending on whether the report is sent as a result of user interaction. 


CallLegConnectedToAddressTime 


TpDateAndTime 


The date and time when the call leg was connected to the destination (i.e. 

when the destination answered the call). If the destination did not answer, 

the time is set to an empty string. 

Either this element is vaUd or the CallConnectedToResourceTime is 

vaUd, depending on whether the report is sent as a result of user 

interaction. 


CallLegEndTime 


TpDateAndTime 


The date and time when the call leg was released. 


Connect edAddress 


TpAddress 


The address of the party associated with the leg. If during the call the 

connected address was received from the party then this is returned, 

otherwise the destination address (for legs connected to a destination) or 

the originating address (for legs connected to the origination) is returned. 


CallLegReleaseCause 


TpReleaseCause 


The cause of the termination. May be present with 
P_CALL_LEG_INFO_RELEASE_CAUSE was specified. 


CallAppInfo 


TpCallAppInfoSet 


Additional information for the leg. May be present with 
P_CALL_LEG_INFO_APPINFO was specified. 
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TpCallLeglnfoType 

Defines the type of call leg information requested and reported. The values may be combined by a logical 'OR' function. 



Name 


Value 


Description 


P_CALL_LEG_INFO_UNDEFINED 


OOh 


Undefined 


P_CALL_LEG_INFO_TIMES 


Olh 


Relevant call times 


P_CALL_LEG_INFO_RELEASE_CAUSE 


02h 


Call leg release cause 


P_CALL_LEG_INFO_ADDRESS 


04h 


Call leg connected address 


P_CALL_LEG_INFO_APP INFO 


08h 


Call leg application related information 



7 



Common Call Control Data Types 



TpCallAlertingMechanism 

This data type is identical to a Tpint 3 2 , and defines the mechanism that will be used to alert a call party. The values 
of this data type are operator specific. 

TpCallBearerService 

This data type defines the type of call application-related specific information (Q.931: Information Transfer Capability, 
and 3G TS 22.002) 



Name 


Value 


Description 


P_CALL_BEARER_SERVICE_UNKNOWN 





Bearer capability information unknown at this time 


P_CALL_BEARER_SERVICE_SPEECH 


1 


Speech 


P_CALL_BEARER_SERVICE_DIGITALUNRESTRICTED 


2 


Unrestricted digital information 


P_CALL_BEARER_SERVICE_DIGITALRESTRICTED 


3 


Restricted digital information 


P_CALL_BEARER_SERVICE_AUDIO 


4 


3.1 kHz audio 


P_CALL_BEARER_SERVICE_ 
DIGITALUNRESTRICTEDTONES 


5 


Unrestricted digital information with tomes/announcements 


P_CALL_BEARER_SERVICE_VIDEO 


6 


Video 



TpCallChargePlan 

Defines the Sequence of Data Elements that specify the charge plan for the call. 



Sequence Element Name 


Sequence Element Type 


Description 


Char geOrder Type 


TpCallChargeOrderCategory 


Charge order 


Transparent Charge 


TpOctetSet 


Operator specific charge plan specification, 

e.g. charging table name / charging table 

entry. The associated charge plan data will be 

send transparently to the charging records. 

Only appHcable when transparent charging is 
selected. 


ChargePlan 


Tplnt32 


Pre-defined charge plan. Example of the 

charge plan set from which the appHcation 

can choose could be : (0 = normal user, 1 = 

silver card user, 2 = gold card user). 

Only applicable when transparent charging is 
selected. 


Additional Info 


TpOctetSet 


Descriptive string which is sent to the billing 

system without prior evaluation. Could be 

included in the ticket. 


PartyToCharge 


TpCallPartyToCharge 


Identifies the entity or party to be charged for 
the call or call leg. 



TpCallPartyToCharge 
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Defines the Tagged Choice of Data Elements that identifies the entity or party to be charged. 





Tag Element Type 








TpCallPartyToChargeType 







Tag Element Value 


Choice Element 
Type 


Choice Element Name 


P_CALL_PARTY_ORIGINATING, , 


NULL 


Undefined 


P_CALL_PARTY_DESTINATION, 


NULL 


Undefined 


P_CALL_PARTY_SPECIAL 


Tp Address 


CallPartySpecial 



TpCallPartyToChargeType 

Defines the type of call party to charge 



Name 


Value 


Description i 


P_CALL_PARTY_ORIGINATING, , 





Calling party, i.e. party that initiated the call. For application initiated calls this 
indicates the first party of the call 


P_CALL_PARTY_DESTINATION, 


1 


Called party 


P_CALL_PARTY_SPECIAL 


2 


An address identifying e.g. a third party, a service provider 



TpCallChargeOrder 

Defines the Tagged Choice of Data Elements that specify the charge plan for the call. 





Tag Element Type 






TpCallChargeOrderCategory 





Tag Element Value 


Choice Element Type 


Choice Element Name 








P_CALL_CHARGE_TRANSPARENT 


TpOctetSet 


Transparent Charge 


P_CALL_CHARGE_PREDEFINED_SET 


Tplnt32 


ChargePlan 



TpCallChargeOrderCategory 

Defines the type of charging to be applied 



Name 


Value 


Description 


P_CALL_CHARGE_TRANSPARENT 





operator specific charge plan specification, e.g. charging table name / 

charging table entry. The associated charge plan data will be send 

transparently to the charging records 


P_CALL_CHARGE_PREDEFINED_SET 


1 


Pre-defined charge plan. Example of the charge plan set from which the 

application can choose could be : (0 = normal user, 1 = silver card user, 2 = 

gold card user). 



TpCallAdditionalChargePlanlnfo 

Defines the Tagged Choice of Data Elements that specify the charge plan for the call. 





Tag Element Type 






TpCallChargeOrderCategory 
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Tag Element Value 


Choice Element 
Type 


Choice Element 
Name 


Description 










P_CALL_CHARGE_TRANSPARENT 


NULL 


Undefined 




P_CALL_CHARGE_PREDEFINED_SET 


TpOctetSet 


SetAdditionallnfo 


Descriptive string which is sent to 

the biUing system without prior 

evaluation. Could be included in 

the ticket. 



TpCallEndedReport 

Defines the Sequence of Data Elements that specify the reason for the call ending. 



Sequence Element Name 


Sequence Element Type 


Description 


CallLegSessionID 


TpSessionID 


The leg that initiated the release of the call. 

If the call release was not initiated by the leg, 
then this value is set to -1. 


Cause 


TpReleaseCause 


The cause of the call ending. 



TpCallError 

Defines the Sequence of Data Element s that specify the additional information relating to acall error. 



Sequence Element Name 


Sequence Element Type 


ErrorTime 


TpDateAndTime 


ErrorType 


TpCallErrorType 


AdditionalErrorlnfo 


TpCallAdditionalErrorlnfo 



TpCallAdditionalErrorlnfo 

Defines the Tagged Choice of Data Elements that specify additional call error and call error specific 
information. This is also used to specify call leg errors and information errors. 





Tag Element Type 






TpCallErrorType 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_CALL_ERROR_UNDEF INED 


NULL 


Undefined 


P_CALL_ERROR_INVALID_ADDRESS 


TpAddressError 


CallErrorlnvalidAddress 


P_CALL_ERROR_INVALID_STATE 


NULL 


Undefined 


P_CALL_ERROR_RESOURCE_UNAVAILABLE 


NULL 


Undefined 



TpCallErrorType 

Defines a specific call error. 



Name 


Value 


Description 


P_CALL_ERROR_UNDEFINED 





Undefined; the method failed or was refused, 
but no specific reason can be given. 


P_CALL_ERROR_INVALID_ADDRESS 


1 


The operation failed because an invalid address 
was given 


P_CALL_ERROR_INVALID_STATE 


2 


The call was not in a vaUd state for the 
requested operation 


P_CALL_ERROR_RESOURCE_UNAVAILABLE 


3 


There are not enough resources to complete the 
request successfully 
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TpCalllnfoReport 

Defines the Sequence of Data Element s that specify the call information requested. Information that was not 
requested is invalid. 



Sequence Element Name 


Sequence Element Type 


Description 


CalllnfoType 


TpCalllnfoType 


The type of call report. 


Call InitiationSt art Time 


TpDateAndTime 


The time and date when the call, or follow-on 
call, was started. 


CallConnectedToResourceTime 


TpDateAndTime 


The date and time when the call was connected to 
the resource. 

This data element is only valid when information 
on user interaction is reported. 


CallConnectedToDestinationTime 


TpDateAndTime 


The date and time when the call was connected to 

the destination (i.e., when the destination 

answered the call). If the destination did not 

answer, the time is set to an empty string. 

This data element is invalid when information on 

user interaction is reported with an intermediate 

report. 


CallEndTime 


TpDateAndTime 


The date and time when the call or follow-on call 
or user interaction was terminated. 


Cause 


TpReleaseCause 


The cause of the termination. 



A calllnfoReport will be generated at the end of user interaction and at the end of the connection with the associated 
address. This means that either the destination related information is present or the resource related information, but not 
both. 



TpCalllnfoType 

Defines the type of call information requested and reported. The values may be combined by a logical 'OR' function. 



Name 


Value 


Description 


P_CALL_INFO_UNDEF INED 


OOh 


Undefined 


P_CALL_INFO_TIMES 


Olh 


Relevant call times 


P_CALL_INFO_RELEASE_CAUSE 


02h 


Call release cause 


P_CALL_INFO_INTERMED I ATE 


04h 


Send only intermediate reports. When this is not specified the information report 

will only be sent when the call has ended. When intermediate reports are 

requested a report will be generated between follow-on calls, i.e., when a party 

leaves the call. 



TpCallLoadControlMechanism 

Defines the Tagged Choice of Data Elements that specify the applied mechanism and associated parameters. 





Tag Element Type 






TpCallLoadControlMechanismType 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_CALL_LOAD_CONTROL_PER_INTERVAL 


TpCallLoadControlIntervalRate 


CallLoadControlPer Interval 



TpCallLoadControlIntervalRate 

Defines the call admission rate of the call load control mechanism used. This data type indicates the interval (in 
milliseconds) between calls that are admitted. 
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Name 


Value 


Description 


P_CALL_LOAD_CONTROL_ADMIT_NO_CALLS 





Infinite interval 
(do not admit any calls) 




1 - 60000 


Duration in milliseconds 



TpCallLoadControlMechanismType 

Defines the type of call load control mechanism to use. 



Name 


Value 


Description 


P_CALL_LOAD_CONTROL_PER_INTERVAL 


1 


admit one call per interval 



TpCallMonitorMode 

Defines the mode that the call will monitor for events, or the mode that the call is in following a detected event. 



Name 


Value 


Description 


P_CALL_MONI TOR_MODE_INTERRUP T 





The call event is intercepted by the call control 
service and call processing is interrupted. The 

application is notified of the event and call 

processing resumes following an appropriate 

API call or network event (such as a call 

release) 


P_CALL_MONITOR_MODE_NOTIFY 


1 


The call event is detected by the call control 
service but not intercepted. The appHcation is 
notified of the event and call processing 
continues 


P_CALL_MONITOR_MODE_DO_NOT_MONITOR 


2 


Do not monitor for the event 



TpCallNetworkAccessType 

This data defines the bearer capabilities associated with the call. (3G TS 24.002) This information is network operator 
specific and may not always be available because there is no standard protocol to retrieve the information. 



Name 


Value 


Description 


P_CALL_NETWORK_ACCESS_TYPE_UNKNOWN 





Network type information unknown at this time 


P_CALL_NETWORK_ACCESS_TYPE_POT 


1 


POTS 


P_CALL_NETWORK_ACCESS_TYPE_ISDN 


2 


ISDN 


P_CALL_NE TWORK_ACCESS_TYPE_D I ALUP INTERNET 


3 


Dial-up Internet 


P_CALL_NETWORK_ACCESS_TYPE_XDSL 


4 


xDLS 


P_CALL_NETWORK_ACCESS_TYPE_WIRELESS 


5 


Wireless 



TpCallPartyCategory 

This data type defines the category of a calling party. (Q.763: Calling Party Category / Called Party Category) 
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Name 


Value 


Description 


P_CALL_PARTY_CATEGORY_UNKNOWN 





calling party's category unknown at this time 


P_CALL_PARTY_CATEGORY_OPERATOR_F 


1 


operator, language French 


P_CALL_PARTY_CATEGORY_OPERATOR_E 


2 


operator, language EngHsh 


P_CALL_PARTY_CATEGORY_OPERATOR_G 


3 


operator, language German 


P_CALL_PARTY_CATEGORY_OPERATOR_R 


4 


operator, language Russian 


P_CALL_PARTY_CATEGORY_OPERATOR_S 


5 


operator, language Spanish 


P_CALL_PARTY_CATEGORY_ORDINARY_SUB 


6 


ordinary caUing subscriber 


P_CALL_PARTY_CATEGORY_PRIORITY_SUB 


7 


calling subscriber with priority 


P_CALL_PARTY_CATEGORY_DATA_CALL 


8 


data call (voice band data) 


P_CALL_PARTY_CATEGORY_TEST_CALL 


9 


test call 


P_CALL_PARTY_CATEGORY_PAYPHONE 


10 


payphone 



TpCallServiceCode 

Defines the Sequence of Data Element s that specify the service code and type of service code received during 
a call. The service code type defines how the value string should be interpreted. 



Sequence Element Name 


Sequence Element Type 


CallServiceCodeType 


TpCallServiceCodeType 


ServiceCode Value 


TpString 



TpCallServiceCodeType 

Defines the different types of service codes that can be received during the call. 



Name 


Value 


Description 


P_CALL_SERVICE_CODE_UNDEFINED 





The type of service code is unknown. The corresponding string is 
operator specific. 


P_CALL_SERVICE_CODE_DIGITS 


1 


The user entered a digit sequence during the call. The corresponding 
string is an ascii representation of the received digits. 


P_CALL_SERVICE_CODE_FACILITY 


2 


A faciUty information element is received. The corresponding string 
contains the facility information element as defined in ITU Q.932 


P_CALL_SERVICE_C0DE_U2U 


3 


A user-to-user message was received. The associated string contains 
the content of the user-to-user information element. 


P_CALL_SERVICE_CODE_HOOKFLASH 


4 


The user performed a hookflash, optionally followed by some digits. 

The corresponding string is an ascii representation of the entered 

digits. 


P_CALL_SERVICE_CODE_RECALL 


5 


The user pressed the register recall button, optionally followed by 

some digits. The corresponding string is an ascii representation of the 

entered digits. 



TpCallSuperviseReport 

Defines the responses from the call control service for calls that are supervised. The values may be combined by a 
logical 'OR' function. 



Name 


Value 


Description 


P_CALL_SUPERVISE_TIMEOUT 


01h 


The call supervision timer has expired 


P_CALL_SUPERVISE_CALL_ENDED 


02h 


The call has ended, either due to timer 
expiry or call party release. In case the 
called party disconnects but a follow-on 
call can still be made also this indication is 
used. 


P_CALL_SUPERVISE_TONE_APPLIED 


04h 


A warning tone has been applied. This is 

only sent in combination with 

P CALL SUPERVISE TIMEOUT 


P_CALL_SUPERVISE_UI_F INI SHED 





The user interaction has finished. 



TpCallSuperviseTreatment 
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Defines the treatment of the call by the call control service when the call supervision timer expires. The values may be 
combined by a logical 'OR' function. 



Name 


Value 


Description 


P_CALL_SUPERVISE_RELEASE 


Olh 


Release the call when the call supervision timer expires 


P_CALL_SUPERVISE_RESPOND 


02h 


Notify the appHcation when the call supervision timer expires 


P_CALL_SUPERVISE_APPLY_TONE 


04h 


Send a warning tone to the originating party when the call supervision 

timer expires. If call release is requested, then the call will be released 

following the tone after an administered time period 



TpCallTeleService 

This data type defines the tele-service associated with the call. (Q.763: User Teleservice Information, Q.931: High 
Layer Compatitibility Information, and 3G TS 22.003) 



Name 


Value 


Description 


P_CALL_TELE_SERVICE_UNKNOWN 





Teleservice information unknown at this time 


P_CALL_TELE_SERVICE_TELEPHONY 


1 


Telephony 


P_CALL_TELE_SERVICE_FAX_2_3 


2 


Facsimile Group 2/3 


P_CALL_TELE_SERVICE_FAX_4_I 


3 


Facsimile Group 4, Class I 


P_CALL_TELE_SERVICE_FAX_4_I I_I I I 


4 


Facsimile Group 4, Classes II and III 


P_CALL_TELE_SERVICE_VIDEOTEX_SYN 


5 


Syntax based Videotex 


P_CALL_TELE_SERVICE_VIDEOTEX_INT 


6 


International Videotex interworking via gateways or interworking units 


P_CALL_TELE_SERVICE_TELEX 


7 


Telex service 


P_CALL_TELE_SERVICE_MHS 


8 


Message Handling Systems 


P_CALL_TELE_SERVICE_OSI 


9 


OSI application 


P_CALL_TELE_SERVICE_FTAM 


10 


FT AM application 


P_CALL_TELE_SERVICE_VIDEO 


11 


Videotelephony 


P_CALL_TELE_SERVICE_VIDEO_CONF 


12 


Videoconferencing 


P_CALL_TELE_SERVICE_AUDIOGRAPH_CONF 


13 


Audiographic conferencing 


P_CALL_TELE_SERVICE_MULTIMEDIA 


14 


Multimedia services 


P_CALL_TELE_SERVICE_CS_INI_H2 21 


15 


Capability set of initial channel of H.221 


P_CALL_TELE_SERVICE_CS_SUB_H2 21 


16 


Capability set of subsequent channel of H.221 


P_CALL_TELE_SERVICE_CS_INI_CALL 


17 


Capability set of initial channel associated with an active 3.1 kHz audio or speech 
call. 


P_CALL_TELE_SERVICE_DATATRAFFIC 


18 


Data traffic. 


P_CALL_TELE_SERVICE_EMERGENCY_CALLS 


19 


Emergency Calls 


P_CALL_TELE_SERVICE_SMS_MT_PP 


20 


Short message MT/PP 


P_CALL_TELE_SERVICE_SMS_MO_PP 


21 


Short message MO/PP 


P_CALL_TELE_SERVICE_CELL_BROADCAST 


22 


Cell Broadcast Service 


P_CALL_TELE_SERVICE_ALT_SPEECH_FAX_3 


23 


Alternate speech and facsimile group 3 


P_CALL_TELE_SERVICE_AUT0MATIC_FAX_3 


24 


Automatic Facsimile group 3 


P_CALL_TELE_SERVICE_VOICE_GROUP_CALL 


25 


Voice Group Call Service 


P_CALL_TELE_SERVICE_VOICE_BROADCAST 


26 


Voice Broadcast Service 



TpCallTreatment 

Defines the Sequence of Data Elements that specify the the treatment for calls that will be handled only by the 
network (for example, call which are not admitted by the call load control mechanism). 
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Sequence Element Name 


Sequence Element Type 


CallTreatmentType 


TpCallTreatmentType 


ReleaseCause 


TpReleaseCause 


AdditionalTreatmentlnfo 


TpCallAdditionalTreatmentlnfo 



TpCallTreatmentType 

Defines the treatment for calls that will be handled only by the network. 



Name 


Value 


Description 


P_CALL_TREATMENT_DEFAULT 





Default treatment 


P_CALL_TREATMENT_RELEASE 


1 


Release the call 


P_CALL_TREATMENT_S I AR 


2 


Send information to the user, and release the 
call (Send Info & Release) 



TpCallAdditionalTreatmentlnfo 

Defines the Tagged Choice of Data Element s that specify the information to be sent to a call party. 





Tag Element Type 






TpCallTreatmentType 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_CALL_TREATMENT_DEFAULT 


NULL 


Undefined 


P_CALL_TREATMENT_RELEASE 


NULL 


Undefined 


P_CALL_TREATMENT_S I AR 


TpUIInfo 


InformationToSend 



TpMediaType 

Defines the media type of a media stream. The values may be combined by a logical 'OR' function. 



Name 


Value 


Description 


P_AUDIO 


1 


Audio stream 


P_VIDEO 


2 


Video stream 


P_DATA 


4 


Data stream (e.g., T120) 
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Annex A (normative): 

OMG IDL Description of Call Control SCF 

The OMG IDL representation of this interface specification is contained in text files (contained in archive 
2919804IDL.ZIP) which accompany the present document. 
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Annex B (informative): 

Differences between this draft and 3GPP TS 29.198 R99 

The following is a list of the differences between the present document and 3GPP TS 29.198 R99, for those interfaces 
which are common to both documents. Any new interfaces with respect to Release 99 are not listed. 

B.1 Interface IpCallControlManager 

enableCallNotification (app CallControlManager lnterface : in IpAppCallControlManagerRef, eventCriteria : in 
TpCallEventCriteria, assignmentID : out TpAssignmentlDRef) : TpResult 

createCall (appCall : in IpAppCallRef, callReference : out TpCallldentifierRef) : TpResult 

setCallLoadControl (duration : in TpDuration, mechanism : in TpCallLoadControlMechanism, treatment : in 
TpCallTreatment, addressRange : in TpAddressRange, assignmentID : out TpAssignmentlDRef) : TpResult 

B.2 Interface IpAppCallControlManager 

callEventNotify (callReference : in TpCallldentifier, eventlnfo : in TpCallEventlnfo, assignmentID : in 
TpAssignmentID, app Call lnterface : out IpAppCallRefRef) : TpResult 

callOverloadEncountered (assignmentID : in Tp AssignmentID) : TpResult 

callOverloadCeased (assignmentID : in TpAssignmentID) : TpResult 

B.3 Interface IpCall 

getMoreDialledDigitsReq (callSessionID : in TpSessionID, length : in Tplnt32) : TpResult 

B.4 Interface IpAppCall 

getMoreDialledDigitsRes (callSessionID : in TpSessionID, digits : in TpString) : TpResult 
getMoreDialledDigitsErr (callSessionID : in TpSessionID, errorlndication : in TpCallError) : TpResult 

B.5 All Generic Call Control Interfaces 

All methods now return void or the former out parameter. 
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Annex C (informative): 
Change history 



Change history 


Date 


TSG# 


TSG Doc. 


CR 


Rev 


Subject/Comment 


Old 


New 


Mar 2001 


CN 11 


NP-010134 


047 


- 


CR 29.198: for moving TS 29.198 from R99 to Rel 4 (N5-010158) 


3.2.0 


1.0.0 


June 2001 


CN 12 


NP-010327 


-- 


-- 


Approved at TSG CN#12 and placed under Change Control 


2.0.0 


4.0.0 


Sep 2001 


CN 13 


NP-010467 


001 


- 


Changing references to JAIN 


4.0.0 


4.1.0 


Sep 2001 


CN_13 


NP-010467 


002 


- 


Correction of text descriptions for methods enableCallNotification and 
createNotification 


4.0.0 


4.1.0 


Sep 2001 


CN 13 


NP-010467 


003 


-- 


Specify the behaviour when a call leg times out 
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